getargv 0.3.2-universal-darwin → 0.3.3-universal-darwin

data/vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/ext/rbs_extension/parser.c

@@ -0,0 +1,2559 @@
+#include "rbs_extension.h"
+
+#define INTERN_TOKEN(parserstate, tok) \
+  rb_intern3(\
+    peek_token(parserstate->lexstate, tok),\
+    token_bytes(tok),\
+    rb_enc_get(parserstate->lexstate->string)\
+  )
+
+#define KEYWORD_CASES \
+  case kBOOL:\
+  case kBOT: \
+  case kCLASS: \
+  case kFALSE: \
+  case kINSTANCE: \
+  case kINTERFACE: \
+  case kNIL: \
+  case kSELF: \
+  case kSINGLETON: \
+  case kTOP: \
+  case kTRUE: \
+  case kVOID: \
+  case kTYPE: \
+  case kUNCHECKED: \
+  case kIN: \
+  case kOUT: \
+  case kEND: \
+  case kDEF: \
+  case kINCLUDE: \
+  case kEXTEND: \
+  case kPREPEND: \
+  case kALIAS: \
+  case kMODULE: \
+  case kATTRREADER: \
+  case kATTRWRITER: \
+  case kATTRACCESSOR: \
+  case kPUBLIC: \
+  case kPRIVATE: \
+  case kUNTYPED: \
+  /* nop */
+
+typedef struct {
+  VALUE required_positionals;
+  VALUE optional_positionals;
+  VALUE rest_positionals;
+  VALUE trailing_positionals;
+  VALUE required_keywords;
+  VALUE optional_keywords;
+  VALUE rest_keywords;
+} method_params;
+
+// /**
+//  * Returns RBS::Location object of `current_token` of a parser state.
+//  *
+//  * @param state
+//  * @return New RBS::Location object.
+//  * */
+static VALUE rbs_location_current_token(parserstate *state) {
+  return rbs_location_pp(
+    state->buffer,
+    &state->current_token.range.start,
+    &state->current_token.range.end
+  );
+}
+
+static VALUE parse_optional(parserstate *state);
+static VALUE parse_simple(parserstate *state);
+
+static VALUE string_of_loc(parserstate *state, position start, position end) {
+  return rb_enc_str_new(
+    RSTRING_PTR(state->lexstate->string) + start.byte_pos,
+      end.byte_pos - start.byte_pos,
+      rb_enc_get(state->lexstate->string)
+  );
+}
+
+/**
+ * Raises RuntimeError with "Unexpected error " messsage.
+ * */
+static NORETURN(void) rbs_abort(void) {
+  rb_raise(
+    rb_eRuntimeError,
+    "Unexpected error"
+  );
+}
+
+NORETURN(void) raise_syntax_error(parserstate *state, token tok, const char *fmt, ...) {
+  va_list args;
+  va_start(args, fmt);
+  VALUE message = rb_vsprintf(fmt, args);
+  va_end(args);
+
+  VALUE location = rbs_new_location(state->buffer, tok.range);
+  VALUE type = rb_str_new_cstr(token_type_str(tok.type));
+
+  VALUE error = rb_funcall(
+    RBS_ParsingError,
+    rb_intern("new"),
+    3,
+    location,
+    message,
+    type
+  );
+
+  rb_exc_raise(error);
+}
+
+typedef enum {
+  CLASS_NAME = 1,
+  INTERFACE_NAME = 2,
+  ALIAS_NAME = 4
+} TypeNameKind;
+
+void parser_advance_no_gap(parserstate *state) {
+  if (state->current_token.range.end.byte_pos == state->next_token.range.start.byte_pos) {
+    parser_advance(state);
+  } else {
+    raise_syntax_error(
+      state,
+      state->next_token,
+      "unexpected token"
+    );
+  }
+}
+
+/*
+  type_name ::= {`::`} (tUIDENT `::`)* <tXIDENT>
+              | {(tUIDENT `::`)*} <tXIDENT>
+              | {<tXIDENT>}
+*/
+VALUE parse_type_name(parserstate *state, TypeNameKind kind, range *rg) {
+  VALUE absolute = Qfalse;
+  VALUE path = rb_ary_new();
+  VALUE namespace;
+
+  if (rg) {
+    rg->start = state->current_token.range.start;
+  }
+
+  if (state->current_token.type == pCOLON2) {
+    absolute = Qtrue;
+    parser_advance_no_gap(state);
+  }
+
+  while (
+    state->current_token.type == tUIDENT
+    && state->next_token.type == pCOLON2
+    && state->current_token.range.end.byte_pos == state->next_token.range.start.byte_pos
+    && state->next_token.range.end.byte_pos == state->next_token2.range.start.byte_pos
+  ) {
+    rb_ary_push(path, ID2SYM(INTERN_TOKEN(state, state->current_token)));
+
+    parser_advance(state);
+    parser_advance(state);
+  }
+  namespace = rbs_namespace(path, absolute);
+
+  switch (state->current_token.type) {
+    case tLIDENT:
+      if (kind & ALIAS_NAME) goto success;
+      goto error;
+    case tULIDENT:
+      if (kind & INTERFACE_NAME) goto success;
+      goto error;
+    case tUIDENT:
+      if (kind & CLASS_NAME) goto success;
+      goto error;
+    default:
+      goto error;
+  }
+
+  success: {
+    if (rg) {
+      rg->end = state->current_token.range.end;
+    }
+
+    return rbs_type_name(namespace, ID2SYM(INTERN_TOKEN(state, state->current_token)));
+  }
+
+  error: {
+    VALUE ids = rb_ary_new();
+    if (kind & ALIAS_NAME) {
+      rb_ary_push(ids, rb_str_new_literal("alias name"));
+    }
+    if (kind & INTERFACE_NAME) {
+      rb_ary_push(ids, rb_str_new_literal("interface name"));
+    }
+    if (kind & CLASS_NAME) {
+      rb_ary_push(ids, rb_str_new_literal("class/module/constant name"));
+    }
+
+    VALUE string = rb_funcall(ids, rb_intern("join"), 1, rb_str_new_cstr(", "));
+
+    raise_syntax_error(
+      state,
+      state->current_token,
+      "expected one of %"PRIsVALUE,
+      string
+    );
+  }
+}
+
+/*
+  type_list ::= {} type `,` ... <`,`> eol
+              | {} type `,` ... `,` <type> eol
+*/
+static VALUE parse_type_list(parserstate *state, enum TokenType eol, VALUE types) {
+  while (true) {
+    rb_ary_push(types, parse_type(state));
+
+    if (state->next_token.type == pCOMMA) {
+      parser_advance(state);
+
+      if (state->next_token.type == eol) {
+        break;
+      }
+    } else {
+      if (state->next_token.type == eol) {
+        break;
+      } else {
+        raise_syntax_error(
+          state,
+          state->next_token,
+          "comma delimited type list is expected"
+        );
+      }
+    }
+  }
+
+  return types;
+}
+
+static bool is_keyword_token(enum TokenType type) {
+  switch (type)
+  {
+  case tLIDENT:
+  case tUIDENT:
+  case tULIDENT:
+  case tULLIDENT:
+  case tQIDENT:
+  case tBANGIDENT:
+  KEYWORD_CASES
+    return true;
+  default:
+    return false;
+  }
+}
+
+/*
+  function_param ::= {} <type>
+                   | {} type <param>
+*/
+static VALUE parse_function_param(parserstate *state) {
+  range type_range;
+
+  type_range.start = state->next_token.range.start;
+  VALUE type = parse_type(state);
+  type_range.end = state->current_token.range.end;
+
+  if (state->next_token.type == pCOMMA || state->next_token.type == pRPAREN) {
+    range param_range = type_range;
+
+    VALUE location = rbs_new_location(state->buffer, param_range);
+    rbs_loc *loc = rbs_check_location(location);
+    rbs_loc_add_optional_child(loc, rb_intern("name"), NULL_RANGE);
+
+    return rbs_function_param(type, Qnil, location);
+  } else {
+    range name_range = state->next_token.range;
+    range param_range;
+
+    parser_advance(state);
+    param_range.start = type_range.start;
+    param_range.end = name_range.end;
+
+    VALUE name = rb_to_symbol(rbs_unquote_string(state, state->current_token.range, 0));
+    VALUE location = rbs_new_location(state->buffer, param_range);
+    rbs_loc *loc = rbs_check_location(location);
+    rbs_loc_add_optional_child(loc, rb_intern("name"), name_range);
+
+    return rbs_function_param(type, name, location);
+  }
+}
+
+static ID intern_token_start_end(parserstate *state, token start_token, token end_token) {
+  return rb_intern3(
+    peek_token(state->lexstate, start_token),
+    end_token.range.end.byte_pos - start_token.range.start.byte_pos,
+    rb_enc_get(state->lexstate->string)
+  );
+}
+
+/*
+  keyword_key ::= {} <keyword> `:`
+                | {} keyword <`?`> `:`
+*/
+static VALUE parse_keyword_key(parserstate *state) {
+  VALUE key;
+
+  parser_advance(state);
+
+  if (state->next_token.type == pQUESTION) {
+    key = ID2SYM(intern_token_start_end(state, state->current_token, state->next_token));
+    parser_advance(state);
+  } else {
+    key = ID2SYM(INTERN_TOKEN(state, state->current_token));
+  }
+
+  return key;
+}
+
+/*
+  keyword ::= {} keyword `:` <function_param>
+*/
+static void parse_keyword(parserstate *state, VALUE keywords) {
+  VALUE key;
+  VALUE param;
+
+  key = parse_keyword_key(state);
+  parser_advance_assert(state, pCOLON);
+  param = parse_function_param(state);
+
+  rb_hash_aset(keywords, key, param);
+
+  return;
+}
+
+/*
+Returns true if keyword is given.
+
+  is_keyword === {} KEYWORD `:`
+*/
+static bool is_keyword(parserstate *state) {
+  if (is_keyword_token(state->next_token.type)) {
+    if (state->next_token2.type == pCOLON && state->next_token.range.end.byte_pos == state->next_token2.range.start.byte_pos) {
+      return true;
+    }
+
+    if (state->next_token2.type == pQUESTION
+        && state->next_token3.type == pCOLON
+        && state->next_token.range.end.byte_pos == state->next_token2.range.start.byte_pos
+        && state->next_token2.range.end.byte_pos == state->next_token3.range.start.byte_pos) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/*
+  params ::= {} `)`
+           | <required_params> `)`
+           | <required_params> `,` `)`
+
+  required_params ::= {} function_param `,` <required_params>
+                    | {} <function_param>
+                    | {} <optional_params>
+
+  optional_params ::= {} `?` function_param `,` <optional_params>
+                    | {} `?` <function_param>
+                    | {} <rest_params>
+
+  rest_params ::= {} `*` function_param `,` <trailing_params>
+                | {} `*` <function_param>
+                | {} <trailing_params>
+
+  trailing_params ::= {} function_param `,` <trailing_params>
+                    | {} <function_param>
+                    | {} <keywords>
+
+  keywords ::= {} required_keyword `,` <keywords>
+             | {} `?` optional_keyword `,` <keywords>
+             | {} `**` function_param `,` <keywords>
+             | {} <required_keyword>
+             | {} `?` <optional_keyword>
+             | {} `**` <function_param>
+*/
+static void parse_params(parserstate *state, method_params *params) {
+  if (state->next_token.type == pRPAREN) {
+    return;
+  }
+
+  while (true) {
+    VALUE param;
+
+    switch (state->next_token.type) {
+      case pQUESTION:
+        goto PARSE_OPTIONAL_PARAMS;
+      case pSTAR:
+        goto PARSE_REST_PARAM;
+      case pSTAR2:
+        goto PARSE_KEYWORDS;
+      case pRPAREN:
+        goto EOP;
+
+      default:
+        if (is_keyword(state)) {
+          goto PARSE_KEYWORDS;
+        }
+
+        param = parse_function_param(state);
+        rb_ary_push(params->required_positionals, param);
+
+        break;
+    }
+
+    if (!parser_advance_if(state, pCOMMA)) {
+      goto EOP;
+    }
+  }
+
+PARSE_OPTIONAL_PARAMS:
+  while (true) {
+    VALUE param;
+
+    switch (state->next_token.type) {
+      case pQUESTION:
+        parser_advance(state);
+
+        if (is_keyword(state)) {
+          parse_keyword(state, params->optional_keywords);
+          parser_advance_if(state, pCOMMA);
+          goto PARSE_KEYWORDS;
+        }
+
+        param = parse_function_param(state);
+        rb_ary_push(params->optional_positionals, param);
+
+        break;
+      default:
+        goto PARSE_REST_PARAM;
+    }
+
+    if (!parser_advance_if(state, pCOMMA)) {
+      goto EOP;
+    }
+  }
+
+PARSE_REST_PARAM:
+  if (state->next_token.type == pSTAR) {
+    parser_advance(state);
+    params->rest_positionals = parse_function_param(state);
+
+    if (!parser_advance_if(state, pCOMMA)) {
+      goto EOP;
+    }
+  }
+  goto PARSE_TRAILING_PARAMS;
+
+PARSE_TRAILING_PARAMS:
+  while (true) {
+    VALUE param;
+
+    switch (state->next_token.type) {
+      case pQUESTION:
+        goto PARSE_KEYWORDS;
+      case pSTAR:
+        goto EOP;
+      case pSTAR2:
+        goto PARSE_KEYWORDS;
+      case pRPAREN:
+        goto EOP;
+
+      default:
+        if (is_keyword(state)) {
+          goto PARSE_KEYWORDS;
+        }
+
+        param = parse_function_param(state);
+        rb_ary_push(params->trailing_positionals, param);
+
+        break;
+    }
+
+    if (!parser_advance_if(state, pCOMMA)) {
+      goto EOP;
+    }
+  }
+
+PARSE_KEYWORDS:
+  while (true) {
+    switch (state->next_token.type) {
+    case pQUESTION:
+      parser_advance(state);
+      if (is_keyword(state)) {
+        parse_keyword(state, params->optional_keywords);
+      } else {
+        raise_syntax_error(
+          state,
+          state->next_token,
+          "optional keyword argument type is expected"
+        );
+      }
+      break;
+
+    case pSTAR2:
+      parser_advance(state);
+      params->rest_keywords = parse_function_param(state);
+      break;
+
+    case tUIDENT:
+    case tLIDENT:
+    case tULIDENT:
+    case tULLIDENT:
+    case tBANGIDENT:
+    KEYWORD_CASES
+      if (is_keyword(state)) {
+        parse_keyword(state, params->required_keywords);
+      } else {
+        raise_syntax_error(
+          state,
+          state->next_token,
+          "required keyword argument type is expected"
+        );
+      }
+      break;
+
+    default:
+      goto EOP;
+    }
+
+    if (!parser_advance_if(state, pCOMMA)) {
+      goto EOP;
+    }
+  }
+
+EOP:
+  if (state->next_token.type != pRPAREN) {
+    raise_syntax_error(
+      state,
+      state->next_token,
+      "unexpected token for method type parameters"
+    );
+  }
+
+  return;
+}
+
+/*
+  optional ::= {} <simple_type>
+             | {} simple_type <`?`>
+*/
+static VALUE parse_optional(parserstate *state) {
+  range rg;
+  rg.start = state->next_token.range.start;
+  VALUE type = parse_simple(state);
+
+  if (state->next_token.type == pQUESTION) {
+    parser_advance(state);
+    rg.end = state->current_token.range.end;
+    VALUE location = rbs_new_location(state->buffer, rg);
+    return rbs_optional(type, location);
+  } else {
+    return type;
+  }
+}
+
+static void initialize_method_params(method_params *params){
+  params->required_positionals = rb_ary_new();
+  params->optional_positionals = rb_ary_new();
+  params->rest_positionals = Qnil;
+  params->trailing_positionals = rb_ary_new();
+  params->required_keywords = rb_hash_new();
+  params->optional_keywords = rb_hash_new();
+  params->rest_keywords = Qnil;
+}
+
+/*
+  self_type_binding ::= {} <>
+                      | {} `[` `self` `:` type <`]`>
+*/
+static VALUE parse_self_type_binding(parserstate *state) {
+  if (state->next_token.type == pLBRACKET) {
+    parser_advance(state);
+    parser_advance_assert(state, kSELF);
+    parser_advance_assert(state, pCOLON);
+    VALUE type = parse_type(state);
+    parser_advance_assert(state, pRBRACKET);
+    return type;
+  } else {
+    return Qnil;
+  }
+}
+
+/*
+  function ::= {} `(` params `)` self_type_binding? `{` `(` params `)` self_type_binding? `->` optional `}` `->` <optional>
+             | {} `(` params `)` self_type_binding? `->` <optional>
+             | {} self_type_binding? `{` `(` params `)` self_type_binding? `->` optional `}` `->` <optional>
+             | {} self_type_binding? `{` self_type_binding `->` optional `}` `->` <optional>
+             | {} self_type_binding? `->` <optional>
+*/
+static void parse_function(parserstate *state, VALUE *function, VALUE *block, VALUE *function_self_type) {
+  method_params params;
+  initialize_method_params(&params);
+
+  if (state->next_token.type == pLPAREN) {
+    parser_advance(state);
+    parse_params(state, &params);
+    parser_advance_assert(state, pRPAREN);
+  }
+
+  // Passing NULL to function_self_type means the function itself doesn't accept self type binding. (== method type)
+  if (function_self_type) {
+    *function_self_type = parse_self_type_binding(state);
+  }
+
+  VALUE required = Qtrue;
+  if (state->next_token.type == pQUESTION && state->next_token2.type == pLBRACE) {
+    // Optional block
+    required = Qfalse;
+    parser_advance(state);
+  }
+  if (state->next_token.type == pLBRACE) {
+    parser_advance(state);
+
+    method_params block_params;
+    initialize_method_params(&block_params);
+
+    if (state->next_token.type == pLPAREN) {
+      parser_advance(state);
+      parse_params(state, &block_params);
+      parser_advance_assert(state, pRPAREN);
+    }
+
+    VALUE block_self_type = parse_self_type_binding(state);
+
+    parser_advance_assert(state, pARROW);
+    VALUE block_return_type = parse_optional(state);
+
+    *block = rbs_block(
+      rbs_function(
+        block_params.required_positionals,
+        block_params.optional_positionals,
+        block_params.rest_positionals,
+        block_params.trailing_positionals,
+        block_params.required_keywords,
+        block_params.optional_keywords,
+        block_params.rest_keywords,
+        block_return_type
+      ),
+      required,
+      block_self_type
+    );
+
+    parser_advance_assert(state, pRBRACE);
+  }
+
+  parser_advance_assert(state, pARROW);
+  VALUE type = parse_optional(state);
+
+  *function = rbs_function(
+    params.required_positionals,
+    params.optional_positionals,
+    params.rest_positionals,
+    params.trailing_positionals,
+    params.required_keywords,
+    params.optional_keywords,
+    params.rest_keywords,
+    type
+  );
+}
+
+/*
+  proc_type ::= {`^`} <function>
+*/
+static VALUE parse_proc_type(parserstate *state) {
+  position start = state->current_token.range.start;
+  VALUE function = Qnil;
+  VALUE block = Qnil;
+  VALUE proc_self = Qnil;
+  parse_function(state, &function, &block, &proc_self);
+  position end = state->current_token.range.end;
+  VALUE loc = rbs_location_pp(state->buffer, &start, &end);
+
+  return rbs_proc(function, block, loc, proc_self);
+}
+
+/**
+ * ... `{` ... `}` ...
+ *        >   >
+ * */
+/*
+  record_attributes ::= {`{`} record_attribute... <record_attribute> `}`
+
+  record_attribute ::= {} keyword_token `:` <type>
+                     | {} literal_type `=>` <type>
+*/
+VALUE parse_record_attributes(parserstate *state) {
+  VALUE hash = rb_hash_new();
+
+  if (state->next_token.type == pRBRACE) {
+    return hash;
+  }
+
+  while (true) {
+    VALUE key;
+    VALUE type;
+
+    if (is_keyword(state)) {
+      // { foo: type } syntax
+      key = parse_keyword_key(state);
+      parser_advance_assert(state, pCOLON);
+    } else {
+      // { key => type } syntax
+      switch (state->next_token.type) {
+      case tSYMBOL:
+      case tSQSYMBOL:
+      case tDQSYMBOL:
+      case tSQSTRING:
+      case tDQSTRING:
+      case tINTEGER:
+      case kTRUE:
+      case kFALSE:
+        key = rb_funcall(parse_type(state), rb_intern("literal"), 0);
+        break;
+      default:
+        raise_syntax_error(
+          state,
+          state->next_token,
+          "unexpected record key token"
+        );
+      }
+      parser_advance_assert(state, pFATARROW);
+    }
+    type = parse_type(state);
+    rb_hash_aset(hash, key, type);
+
+    if (parser_advance_if(state, pCOMMA)) {
+      if (state->next_token.type == pRBRACE) {
+        break;
+      }
+    } else {
+      break;
+    }
+  }
+
+  return hash;
+}
+
+/*
+  symbol ::= {<tSYMBOL>}
+*/
+static VALUE parse_symbol(parserstate *state) {
+  VALUE string = state->lexstate->string;
+  rb_encoding *enc = rb_enc_get(string);
+
+  int offset_bytes = rb_enc_codelen(':', enc);
+  int bytes = token_bytes(state->current_token) - offset_bytes;
+
+  VALUE literal;
+
+  switch (state->current_token.type)
+  {
+  case tSYMBOL: {
+    char *buffer = peek_token(state->lexstate, state->current_token);
+    literal = ID2SYM(rb_intern3(buffer+offset_bytes, bytes, enc));
+    break;
+  }
+  case tDQSYMBOL:
+  case tSQSYMBOL: {
+    literal = rb_funcall(
+      rbs_unquote_string(state, state->current_token.range, offset_bytes),
+      rb_intern("to_sym"),
+      0
+    );
+    break;
+  }
+  default:
+    rbs_abort();
+  }
+
+  return rbs_literal(
+    literal,
+    rbs_location_current_token(state)
+  );
+}
+
+/*
+ instance_type ::= {type_name} <type_args>
+
+ type_args ::= {} <> /empty/
+             | {} `[` type_list <`]`>
+ */
+static VALUE parse_instance_type(parserstate *state, bool parse_alias) {
+    range name_range;
+    range args_range;
+    range type_range;
+
+    TypeNameKind expected_kind = INTERFACE_NAME | CLASS_NAME;
+    if (parse_alias) {
+      expected_kind |= ALIAS_NAME;
+    }
+
+    VALUE typename = parse_type_name(state, expected_kind, &name_range);
+    VALUE types = rb_ary_new();
+
+    TypeNameKind kind;
+    if (state->current_token.type == tUIDENT) {
+      kind = CLASS_NAME;
+    } else if (state->current_token.type == tULIDENT) {
+      kind = INTERFACE_NAME;
+    } else if (state->current_token.type == tLIDENT) {
+      kind = ALIAS_NAME;
+    } else {
+      rbs_abort();
+    }
+
+    if (state->next_token.type == pLBRACKET) {
+      parser_advance(state);
+      args_range.start = state->current_token.range.start;
+      parse_type_list(state, pRBRACKET, types);
+      parser_advance_assert(state, pRBRACKET);
+      args_range.end = state->current_token.range.end;
+    } else {
+      args_range = NULL_RANGE;
+    }
+
+    type_range.start = name_range.start;
+    type_range.end = nonnull_pos_or(args_range.end, name_range.end);
+
+    VALUE location = rbs_new_location(state->buffer, type_range);
+    rbs_loc *loc = rbs_check_location(location);
+    rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+    rbs_loc_add_optional_child(loc, rb_intern("args"), args_range);
+
+    if (kind == CLASS_NAME) {
+      return rbs_class_instance(typename, types, location);
+    } else if (kind == INTERFACE_NAME) {
+      return rbs_interface(typename, types, location);
+    } else if (kind == ALIAS_NAME) {
+      return rbs_alias(typename, types, location);
+    } else {
+      return Qnil;
+    }
+}
+
+/*
+  singleton_type ::= {`singleton`} `(` type_name <`)`>
+*/
+static VALUE parse_singleton_type(parserstate *state) {
+  range name_range;
+  range type_range;
+
+  parser_assert(state, kSINGLETON);
+
+  type_range.start = state->current_token.range.start;
+  parser_advance_assert(state, pLPAREN);
+  parser_advance(state);
+
+  VALUE typename = parse_type_name(state, CLASS_NAME, &name_range);
+
+  parser_advance_assert(state, pRPAREN);
+  type_range.end = state->current_token.range.end;
+
+  VALUE location = rbs_new_location(state->buffer, type_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+
+  return rbs_class_singleton(typename, location);
+}
+
+/*
+  simple ::= {} `(` type <`)`>
+           | {} <base type>
+           | {} <type_name>
+           | {} class_instance `[` type_list <`]`>
+           | {} `singleton` `(` type_name <`)`>
+           | {} `[` type_list <`]`>
+           | {} `{` record_attributes <`}`>
+           | {} `^` <function>
+*/
+static VALUE parse_simple(parserstate *state) {
+  parser_advance(state);
+
+  switch (state->current_token.type) {
+  case pLPAREN: {
+    VALUE type = parse_type(state);
+    parser_advance_assert(state, pRPAREN);
+    return type;
+  }
+  case kBOOL:
+    return rbs_base_type(RBS_Types_Bases_Bool, rbs_location_current_token(state));
+  case kBOT:
+    return rbs_base_type(RBS_Types_Bases_Bottom, rbs_location_current_token(state));
+  case kCLASS:
+    return rbs_base_type(RBS_Types_Bases_Class, rbs_location_current_token(state));
+  case kINSTANCE:
+    return rbs_base_type(RBS_Types_Bases_Instance, rbs_location_current_token(state));
+  case kNIL:
+    return rbs_base_type(RBS_Types_Bases_Nil, rbs_location_current_token(state));
+  case kSELF:
+    return rbs_base_type(RBS_Types_Bases_Self, rbs_location_current_token(state));
+  case kTOP:
+    return rbs_base_type(RBS_Types_Bases_Top, rbs_location_current_token(state));
+  case kVOID:
+    return rbs_base_type(RBS_Types_Bases_Void, rbs_location_current_token(state));
+  case kUNTYPED:
+    return rbs_base_type(RBS_Types_Bases_Any, rbs_location_current_token(state));
+  case tINTEGER: {
+    VALUE literal = rb_funcall(
+      string_of_loc(state, state->current_token.range.start, state->current_token.range.end),
+      rb_intern("to_i"),
+      0
+    );
+    return rbs_literal(
+      literal,
+      rbs_location_current_token(state)
+    );
+  }
+  case kTRUE:
+    return rbs_literal(Qtrue, rbs_location_current_token(state));
+  case kFALSE:
+    return rbs_literal(Qfalse, rbs_location_current_token(state));
+  case tSQSTRING:
+  case tDQSTRING: {
+    VALUE literal = rbs_unquote_string(state, state->current_token.range, 0);
+    return rbs_literal(
+      literal,
+      rbs_location_current_token(state)
+    );
+  }
+  case tSYMBOL:
+  case tSQSYMBOL:
+  case tDQSYMBOL: {
+    return parse_symbol(state);
+  }
+  case tUIDENT: {
+    ID name = INTERN_TOKEN(state, state->current_token);
+    if (parser_typevar_member(state, name)) {
+      return rbs_variable(ID2SYM(name), rbs_location_current_token(state));
+    }
+    // fallthrough for type name
+  }
+  case tULIDENT: // fallthrough
+  case tLIDENT: // fallthrough
+  case pCOLON2:
+    return parse_instance_type(state, true);
+  case kSINGLETON:
+    return parse_singleton_type(state);
+  case pLBRACKET: {
+    range rg;
+    rg.start = state->current_token.range.start;
+    VALUE types = rb_ary_new();
+    if (state->next_token.type != pRBRACKET) {
+      parse_type_list(state, pRBRACKET, types);
+    }
+    parser_advance_assert(state, pRBRACKET);
+    rg.end = state->current_token.range.end;
+
+    return rbs_tuple(types, rbs_new_location(state->buffer, rg));
+  }
+  case pAREF_OPR: {
+    return rbs_tuple(rb_ary_new(), rbs_new_location(state->buffer, state->current_token.range));
+  }
+  case pLBRACE: {
+    position start = state->current_token.range.start;
+    VALUE fields = parse_record_attributes(state);
+    parser_advance_assert(state, pRBRACE);
+    position end = state->current_token.range.end;
+    VALUE location = rbs_location_pp(state->buffer, &start, &end);
+    return rbs_record(fields, location);
+  }
+  case pHAT: {
+    return parse_proc_type(state);
+  }
+  default:
+    raise_syntax_error(
+      state,
+      state->current_token,
+      "unexpected token for simple type"
+    );
+  }
+}
+
+/*
+  intersection ::= {} optional `&` ... '&' <optional>
+                 | {} <optional>
+*/
+static VALUE parse_intersection(parserstate *state) {
+  range rg;
+
+  rg.start = state->next_token.range.start;
+  VALUE type = parse_optional(state);
+  VALUE intersection_types = rb_ary_new();
+
+  rb_ary_push(intersection_types, type);
+  while (state->next_token.type == pAMP) {
+    parser_advance(state);
+    rb_ary_push(intersection_types, parse_optional(state));
+  }
+
+  rg.end = state->current_token.range.end;
+
+  if (rb_array_len(intersection_types) > 1) {
+    VALUE location = rbs_new_location(state->buffer, rg);
+    type = rbs_intersection(intersection_types, location);
+  }
+
+  return type;
+}
+
+/*
+  union ::= {} intersection '|' ... '|' <intersection>
+          | {} <intersection>
+*/
+VALUE parse_type(parserstate *state) {
+  range rg;
+
+  rg.start = state->next_token.range.start;
+  VALUE type = parse_intersection(state);
+  VALUE union_types = rb_ary_new();
+
+  rb_ary_push(union_types, type);
+  while (state->next_token.type == pBAR) {
+    parser_advance(state);
+    rb_ary_push(union_types, parse_intersection(state));
+  }
+
+  rg.end = state->current_token.range.end;
+
+  if (rb_array_len(union_types) > 1) {
+    VALUE location = rbs_new_location(state->buffer, rg);
+    type = rbs_union(union_types, location);
+  }
+
+  return type;
+}
+
+/*
+  type_params ::= {} `[` type_param `,` ... <`]`>
+                | {<>}
+
+  type_param ::= kUNCHECKED? (kIN|kOUT|) tUIDENT    (module_type_params == true)
+
+  type_param ::= tUIDENT                            (module_type_params == false)
+*/
+
+VALUE parse_type_params(parserstate *state, range *rg, bool module_type_params) {
+  VALUE params = rb_ary_new();
+
+  if (state->next_token.type == pLBRACKET) {
+    parser_advance(state);
+
+    rg->start = state->current_token.range.start;
+
+    while (true) {
+      VALUE name;
+      bool unchecked = false;
+      VALUE variance = ID2SYM(rb_intern("invariant"));
+      VALUE upper_bound = Qnil;
+
+      range param_range = NULL_RANGE;
+      range name_range;
+      range variance_range = NULL_RANGE;
+      range unchecked_range = NULL_RANGE;
+      range upper_bound_range = NULL_RANGE;
+
+      param_range.start = state->next_token.range.start;
+
+      if (module_type_params) {
+        if (state->next_token.type == kUNCHECKED) {
+          unchecked = true;
+          parser_advance(state);
+          unchecked_range = state->current_token.range;
+        }
+
+        if (state->next_token.type == kIN || state->next_token.type == kOUT) {
+          switch (state->next_token.type) {
+          case kIN:
+            variance = ID2SYM(rb_intern("contravariant"));
+            break;
+          case kOUT:
+            variance = ID2SYM(rb_intern("covariant"));
+            break;
+          default:
+            rbs_abort();
+          }
+
+          parser_advance(state);
+          variance_range = state->current_token.range;
+        }
+      }
+
+      parser_advance_assert(state, tUIDENT);
+      name_range = state->current_token.range;
+
+      ID id = INTERN_TOKEN(state, state->current_token);
+      name = ID2SYM(id);
+
+      parser_insert_typevar(state, id);
+
+      if (state->next_token.type == pLT) {
+        parser_advance(state);
+
+        if (state->next_token.type == kSINGLETON) {
+          parser_advance(state);
+          upper_bound = parse_singleton_type(state);
+        } else {
+          parser_advance(state);
+          upper_bound = parse_instance_type(state, false);
+        }
+      }
+
+      param_range.end = state->current_token.range.end;
+
+      VALUE location = rbs_new_location(state->buffer, param_range);
+      rbs_loc *loc = rbs_check_location(location);
+      rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+      rbs_loc_add_optional_child(loc, rb_intern("variance"), variance_range);
+      rbs_loc_add_optional_child(loc, rb_intern("unchecked"), unchecked_range);
+      rbs_loc_add_optional_child(loc, rb_intern("upper_bound"), upper_bound_range);
+
+      VALUE param = rbs_ast_type_param(name, variance, unchecked, upper_bound, location);
+      rb_ary_push(params, param);
+
+      if (state->next_token.type == pCOMMA) {
+        parser_advance(state);
+      }
+
+      if (state->next_token.type == pRBRACKET) {
+        break;
+      }
+    }
+
+    parser_advance_assert(state, pRBRACKET);
+    rg->end = state->current_token.range.end;
+  } else {
+    *rg = NULL_RANGE;
+  }
+
+  rb_funcall(
+    RBS_AST_TypeParam,
+    rb_intern("resolve_variables"),
+    1,
+    params
+  );
+
+  return params;
+}
+
+/*
+  method_type ::= {} type_params <function>
+  */
+VALUE parse_method_type(parserstate *state) {
+  range rg;
+  range params_range = NULL_RANGE;
+  range type_range;
+
+  VALUE function = Qnil;
+  VALUE block = Qnil;
+  parser_push_typevar_table(state, false);
+
+  rg.start = state->next_token.range.start;
+
+  VALUE type_params = parse_type_params(state, &params_range, false);
+
+  type_range.start = state->next_token.range.start;
+
+  parse_function(state, &function, &block, NULL);
+
+  rg.end = state->current_token.range.end;
+  type_range.end = rg.end;
+
+  parser_pop_typevar_table(state);
+
+  VALUE location = rbs_new_location(state->buffer, rg);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("type"), type_range);
+  rbs_loc_add_optional_child(loc, rb_intern("type_params"), params_range);
+
+  return rbs_method_type(
+    type_params,
+    function,
+    block,
+    location
+  );
+}
+
+/*
+  global_decl ::= {tGIDENT} `:` <type>
+*/
+VALUE parse_global_decl(parserstate *state) {
+  range decl_range;
+  range name_range, colon_range;
+
+  VALUE typename;
+  VALUE type;
+  VALUE location;
+  VALUE comment;
+
+  rbs_loc *loc;
+
+  decl_range.start = state->current_token.range.start;
+  comment = get_comment(state, decl_range.start.line);
+
+  name_range = state->current_token.range;
+  typename = ID2SYM(INTERN_TOKEN(state, state->current_token));
+
+  parser_advance_assert(state, pCOLON);
+  colon_range = state->current_token.range;
+
+  type = parse_type(state);
+  decl_range.end = state->current_token.range.end;
+
+  location = rbs_new_location(state->buffer, decl_range);
+  loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range);
+
+  return rbs_ast_decl_global(typename, type, location, comment);
+}
+
+/*
+  const_decl ::= {const_name} `:` <type>
+*/
+VALUE parse_const_decl(parserstate *state) {
+  range decl_range;
+  range name_range, colon_range;
+
+  VALUE typename;
+  VALUE type;
+  VALUE location;
+  VALUE comment;
+
+  rbs_loc *loc;
+
+  decl_range.start = state->current_token.range.start;
+  comment = get_comment(state, decl_range.start.line);
+
+  typename = parse_type_name(state, CLASS_NAME, &name_range);
+
+  parser_advance_assert(state, pCOLON);
+  colon_range = state->current_token.range;
+
+  type = parse_type(state);
+  decl_range.end = state->current_token.range.end;
+
+  location = rbs_new_location(state->buffer, decl_range);
+  loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range);
+
+  return rbs_ast_decl_constant(typename, type, location, comment);
+}
+
+/*
+  type_decl ::= {kTYPE} alias_name `=` <type>
+*/
+VALUE parse_type_decl(parserstate *state, position comment_pos, VALUE annotations) {
+  range decl_range;
+  range keyword_range, name_range, params_range, eq_range;
+
+  parser_push_typevar_table(state, true);
+
+  decl_range.start = state->current_token.range.start;
+  comment_pos = nonnull_pos_or(comment_pos, decl_range.start);
+
+  keyword_range = state->current_token.range;
+
+  parser_advance(state);
+  VALUE typename = parse_type_name(state, ALIAS_NAME, &name_range);
+
+  VALUE type_params = parse_type_params(state, &params_range, true);
+
+  parser_advance_assert(state, pEQ);
+  eq_range = state->current_token.range;
+
+  VALUE type = parse_type(state);
+  decl_range.end = state->current_token.range.end;
+
+  VALUE location = rbs_new_location(state->buffer, decl_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_optional_child(loc, rb_intern("type_params"), params_range);
+  rbs_loc_add_required_child(loc, rb_intern("eq"), eq_range);
+
+  parser_pop_typevar_table(state);
+
+  return rbs_ast_decl_alias(
+    typename,
+    type_params,
+    type,
+    annotations,
+    location,
+    get_comment(state, comment_pos.line)
+  );
+}
+
+/*
+  annotation ::= {<tANNOTATION>}
+*/
+VALUE parse_annotation(parserstate *state) {
+  VALUE content = rb_funcall(state->buffer, rb_intern("content"), 0);
+  rb_encoding *enc = rb_enc_get(content);
+
+  range rg = state->current_token.range;
+
+  int offset_bytes = rb_enc_codelen('%', enc) + rb_enc_codelen('a', enc);
+
+  unsigned int open_char = rb_enc_mbc_to_codepoint(
+    RSTRING_PTR(state->lexstate->string) + rg.start.byte_pos + offset_bytes,
+    RSTRING_END(state->lexstate->string),
+    enc
+  );
+
+  unsigned int close_char;
+
+  switch (open_char) {
+  case '{':
+    close_char = '}';
+    break;
+  case '(':
+    close_char = ')';
+    break;
+  case '[':
+    close_char = ']';
+    break;
+  case '<':
+    close_char = '>';
+    break;
+  case '|':
+    close_char = '|';
+    break;
+  default:
+    rbs_abort();
+  }
+
+  int open_bytes = rb_enc_codelen(open_char, enc);
+  int close_bytes = rb_enc_codelen(close_char, enc);
+
+  char *buffer = RSTRING_PTR(state->lexstate->string) + rg.start.byte_pos + offset_bytes + open_bytes;
+  VALUE string = rb_enc_str_new(
+    buffer,
+    rg.end.byte_pos - rg.start.byte_pos - offset_bytes - open_bytes - close_bytes,
+    enc
+  );
+  rb_funcall(string, rb_intern("strip!"), 0);
+
+  VALUE location = rbs_location_current_token(state);
+
+  return rbs_ast_annotation(string, location);
+}
+
+/*
+  annotations ::= {} annotation ... <annotation>
+                | {<>}
+*/
+void parse_annotations(parserstate *state, VALUE annotations, position *annot_pos) {
+  *annot_pos = NullPosition;
+
+  while (true) {
+    if (state->next_token.type == tANNOTATION) {
+      parser_advance(state);
+
+      if (null_position_p((*annot_pos))) {
+        *annot_pos = state->current_token.range.start;
+      }
+
+      rb_ary_push(annotations, parse_annotation(state));
+    } else {
+      break;
+    }
+  }
+}
+
+/*
+  method_name ::= {} <IDENT | keyword>
+                | {} (IDENT | keyword)~<`?`>
+*/
+VALUE parse_method_name(parserstate *state, range *range) {
+  parser_advance(state);
+
+  switch (state->current_token.type)
+  {
+  case tUIDENT:
+  case tLIDENT:
+  case tULIDENT:
+  case tULLIDENT:
+  KEYWORD_CASES
+    if (state->next_token.type == pQUESTION && state->current_token.range.end.byte_pos == state->next_token.range.start.byte_pos) {
+      range->start = state->current_token.range.start;
+      range->end = state->next_token.range.end;
+      parser_advance(state);
+
+      ID id = rb_intern3(
+        RSTRING_PTR(state->lexstate->string) + range->start.byte_pos,
+        range->end.byte_pos - range->start.byte_pos,
+        rb_enc_get(state->lexstate->string)
+      );
+
+      return ID2SYM(id);
+    } else {
+      *range = state->current_token.range;
+      return ID2SYM(INTERN_TOKEN(state, state->current_token));
+    }
+
+  case tBANGIDENT:
+  case tEQIDENT:
+    *range = state->current_token.range;
+    return ID2SYM(INTERN_TOKEN(state, state->current_token));
+
+  case tQIDENT:
+    return rb_to_symbol(rbs_unquote_string(state, state->current_token.range, 0));
+
+  case pBAR:
+  case pHAT:
+  case pAMP:
+  case pSTAR:
+  case pSTAR2:
+  case pLT:
+  case pAREF_OPR:
+  case tOPERATOR:
+    *range = state->current_token.range;
+    return ID2SYM(INTERN_TOKEN(state, state->current_token));
+
+  default:
+    raise_syntax_error(
+      state,
+      state->current_token,
+      "unexpected token for method name"
+    );
+  }
+}
+
+typedef enum {
+  INSTANCE_KIND,
+  SINGLETON_KIND,
+  INSTANCE_SINGLETON_KIND
+} InstanceSingletonKind;
+
+/*
+  instance_singleton_kind ::= {<>}
+                            | {} kSELF <`.`>
+                            | {} kSELF~`?` <`.`>
+
+  @param allow_selfq `true` to accept `self?` kind.
+*/
+InstanceSingletonKind parse_instance_singleton_kind(parserstate *state, bool allow_selfq, range *rg) {
+  InstanceSingletonKind kind = INSTANCE_KIND;
+
+  if (state->next_token.type == kSELF) {
+    range self_range = state->next_token.range;
+
+    if (state->next_token2.type == pDOT) {
+      parser_advance(state);
+      parser_advance(state);
+      kind = SINGLETON_KIND;
+      rg->start = self_range.start;
+      rg->end = state->current_token.range.end;
+    } else if (
+      state->next_token2.type == pQUESTION
+    && state->next_token.range.end.char_pos == state->next_token2.range.start.char_pos
+    && state->next_token3.type == pDOT
+    && allow_selfq) {
+      parser_advance(state);
+      parser_advance(state);
+      parser_advance(state);
+      kind = INSTANCE_SINGLETON_KIND;
+      rg->start = self_range.start;
+      rg->end = state->current_token.range.end;
+    }
+  } else {
+    *rg = NULL_RANGE;
+  }
+
+  return kind;
+}
+
+/**
+ * def_member ::= {kDEF} method_name `:` <method_types>
+ *              | {kPRIVATE2} kDEF method_name `:` <method_types>
+ *              | {kPUBLIC2} kDEF method_name `:` <method_types>
+ *
+ * method_types ::= {} <method_type>
+ *                | {} <`...`>
+ *                | {} method_type `|` <method_types>
+ *
+ * @param instance_only `true` to reject singleton method definition.
+ * @param accept_overload `true` to accept overloading (...) definition.
+ * */
+VALUE parse_member_def(parserstate *state, bool instance_only, bool accept_overload, position comment_pos, VALUE annotations) {
+  range member_range;
+  range visibility_range;
+  range keyword_range;
+  range name_range;
+  range kind_range;
+  range overload_range = NULL_RANGE;
+
+  VALUE visibility;
+
+  member_range.start = state->current_token.range.start;
+  comment_pos = nonnull_pos_or(comment_pos, member_range.start);
+  VALUE comment = get_comment(state, comment_pos.line);
+
+  switch (state->current_token.type)
+  {
+  case kPRIVATE:
+    visibility_range = state->current_token.range;
+    visibility = ID2SYM(rb_intern("private"));
+    member_range.start = visibility_range.start;
+    parser_advance(state);
+    break;
+  case kPUBLIC:
+    visibility_range = state->current_token.range;
+    visibility = ID2SYM(rb_intern("public"));
+    member_range.start = visibility_range.start;
+    parser_advance(state);
+    break;
+  default:
+    visibility_range = NULL_RANGE;
+    visibility = Qnil;
+    break;
+  }
+
+  keyword_range = state->current_token.range;
+
+  InstanceSingletonKind kind;
+  if (instance_only) {
+    kind_range = NULL_RANGE;
+    kind = INSTANCE_KIND;
+  } else {
+    kind = parse_instance_singleton_kind(state, NIL_P(visibility), &kind_range);
+  }
+
+  VALUE name = parse_method_name(state, &name_range);
+  VALUE method_types = rb_ary_new();
+  VALUE overload = Qfalse;
+
+  if (state->next_token.type == pDOT && RB_SYM2ID(name) == rb_intern("self?")) {
+    raise_syntax_error(
+      state,
+      state->next_token,
+      "`self?` method cannot have visibility"
+    );
+  } else {
+    parser_advance_assert(state, pCOLON);
+  }
+
+  parser_push_typevar_table(state, kind != INSTANCE_KIND);
+
+  bool loop = true;
+  while (loop) {
+    switch (state->next_token.type) {
+    case pLPAREN:
+    case pARROW:
+    case pLBRACE:
+    case pLBRACKET:
+    case pQUESTION:
+      rb_ary_push(method_types, parse_method_type(state));
+      member_range.end = state->current_token.range.end;
+      break;
+
+    case pDOT3:
+      if (accept_overload) {
+        overload = Qtrue;
+        parser_advance(state);
+        loop = false;
+        overload_range = state->current_token.range;
+        member_range.end = overload_range.end;
+        break;
+      } else {
+        raise_syntax_error(
+          state,
+          state->next_token,
+          "unexpected overloading method definition"
+        );
+      }
+
+    default:
+      raise_syntax_error(
+        state,
+        state->next_token,
+        "unexpected token for method type"
+      );
+    }
+
+    if (state->next_token.type == pBAR) {
+      parser_advance(state);
+    } else {
+      loop = false;
+    }
+  }
+
+  parser_pop_typevar_table(state);
+
+  VALUE k;
+  switch (kind) {
+  case INSTANCE_KIND:
+    k = ID2SYM(rb_intern("instance"));
+    break;
+  case SINGLETON_KIND:
+    k = ID2SYM(rb_intern("singleton"));
+    break;
+  case INSTANCE_SINGLETON_KIND:
+    k = ID2SYM(rb_intern("singleton_instance"));
+    break;
+  default:
+    rbs_abort();
+  }
+
+  VALUE location = rbs_new_location(state->buffer, member_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_optional_child(loc, rb_intern("kind"), kind_range);
+  rbs_loc_add_optional_child(loc, rb_intern("overload"), overload_range);
+  rbs_loc_add_optional_child(loc, rb_intern("visibility"), visibility_range);
+
+  return rbs_ast_members_method_definition(
+    name,
+    k,
+    method_types,
+    annotations,
+    location,
+    comment,
+    overload,
+    visibility
+  );
+}
+
+/**
+ * class_instance_name ::= {} <class_name>
+ *                       | {} class_name `[` type args <`]`>
+ *
+ * @param kind
+ * */
+void class_instance_name(parserstate *state, TypeNameKind kind, VALUE *name, VALUE args, range *name_range, range *args_range) {
+  parser_advance(state);
+
+  *name = parse_type_name(state, kind, name_range);
+
+  if (state->next_token.type == pLBRACKET) {
+    parser_advance(state);
+    args_range->start = state->current_token.range.start;
+    parse_type_list(state, pRBRACKET, args);
+    parser_advance_assert(state, pRBRACKET);
+    args_range->end = state->current_token.range.end;
+  } else {
+    *args_range = NULL_RANGE;
+  }
+}
+
+/**
+ *  mixin_member ::= {kINCLUDE} <class_instance_name>
+ *                 | {kPREPEND} <class_instance_name>
+ *                 | {kEXTEND} <class_instance_name>
+ *
+ * @param from_interface `true` when the member is in an interface.
+ * */
+VALUE parse_mixin_member(parserstate *state, bool from_interface, position comment_pos, VALUE annotations) {
+  range member_range;
+  range name_range;
+  range keyword_range;
+  range args_range = NULL_RANGE;
+  bool reset_typevar_scope;
+
+  member_range.start = state->current_token.range.start;
+  comment_pos = nonnull_pos_or(comment_pos, member_range.start);
+
+  keyword_range = state->current_token.range;
+
+  VALUE klass = Qnil;
+  switch (state->current_token.type)
+  {
+  case kINCLUDE:
+    klass = RBS_AST_Members_Include;
+    reset_typevar_scope = false;
+    break;
+  case kEXTEND:
+    klass = RBS_AST_Members_Extend;
+    reset_typevar_scope = true;
+    break;
+  case kPREPEND:
+    klass = RBS_AST_Members_Prepend;
+    reset_typevar_scope = false;
+    break;
+  default:
+    rbs_abort();
+  }
+
+  if (from_interface) {
+    if (state->current_token.type != kINCLUDE) {
+      raise_syntax_error(
+        state,
+        state->current_token,
+        "unexpected mixin in interface declaration"
+      );
+    }
+  }
+
+  parser_push_typevar_table(state, reset_typevar_scope);
+
+  VALUE name;
+  VALUE args = rb_ary_new();
+  class_instance_name(
+    state,
+    from_interface ? INTERFACE_NAME : (INTERFACE_NAME | CLASS_NAME),
+    &name, args, &name_range, &args_range
+  );
+
+  parser_pop_typevar_table(state);
+
+  member_range.end = state->current_token.range.end;
+
+  VALUE location = rbs_new_location(state->buffer, member_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_optional_child(loc, rb_intern("args"), args_range);
+
+  return rbs_ast_members_mixin(
+    klass,
+    name,
+    args,
+    annotations,
+    location,
+    get_comment(state, comment_pos.line)
+  );
+}
+
+/**
+ * @code
+ * alias_member ::= {kALIAS} method_name <method_name>
+ *                | {kALIAS} kSELF `.` method_name kSELF `.` <method_name>
+ * @endcode
+ *
+ * @param[in] instance_only `true` to reject `self.` alias.
+ * */
+VALUE parse_alias_member(parserstate *state, bool instance_only, position comment_pos, VALUE annotations) {
+  range member_range;
+  range keyword_range, new_name_range, old_name_range;
+  range new_kind_range, old_kind_range;
+
+  member_range.start = state->current_token.range.start;
+  keyword_range = state->current_token.range;
+
+  comment_pos = nonnull_pos_or(comment_pos, member_range.start);
+  VALUE comment = get_comment(state, comment_pos.line);
+
+  VALUE new_name;
+  VALUE old_name;
+  VALUE kind;
+
+  if (!instance_only && state->next_token.type == kSELF) {
+    kind = ID2SYM(rb_intern("singleton"));
+
+    new_kind_range.start = state->next_token.range.start;
+    new_kind_range.end = state->next_token2.range.end;
+    parser_advance_assert(state, kSELF);
+    parser_advance_assert(state, pDOT);
+    new_name = parse_method_name(state, &new_name_range);
+
+    old_kind_range.start = state->next_token.range.start;
+    old_kind_range.end = state->next_token2.range.end;
+    parser_advance_assert(state, kSELF);
+    parser_advance_assert(state, pDOT);
+    old_name = parse_method_name(state, &old_name_range);
+  } else {
+    kind = ID2SYM(rb_intern("instance"));
+    new_name = parse_method_name(state, &new_name_range);
+    old_name = parse_method_name(state, &old_name_range);
+
+    new_kind_range = NULL_RANGE;
+    old_kind_range = NULL_RANGE;
+  }
+
+  member_range.end = state->current_token.range.end;
+  VALUE location = rbs_new_location(state->buffer, member_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_required_child(loc, rb_intern("new_name"), new_name_range);
+  rbs_loc_add_required_child(loc, rb_intern("old_name"), old_name_range);
+  rbs_loc_add_optional_child(loc, rb_intern("new_kind"), new_kind_range);
+  rbs_loc_add_optional_child(loc, rb_intern("old_kind"), old_kind_range);
+
+  return rbs_ast_members_alias(
+    new_name,
+    old_name,
+    kind,
+    annotations,
+    location,
+    comment
+  );
+}
+
+/*
+  variable_member ::= {tAIDENT} `:` <type>
+                    | {kSELF} `.` tAIDENT `:` <type>
+                    | {tA2IDENT} `:` <type>
+*/
+VALUE parse_variable_member(parserstate *state, position comment_pos, VALUE annotations) {
+  range member_range;
+  range name_range, colon_range;
+  range kind_range = NULL_RANGE;
+
+  if (rb_array_len(annotations) > 0) {
+    raise_syntax_error(
+      state,
+      state->current_token,
+      "annotation cannot be given to variable members"
+    );
+  }
+
+  member_range.start = state->current_token.range.start;
+  comment_pos = nonnull_pos_or(comment_pos, member_range.start);
+  VALUE comment = get_comment(state, comment_pos.line);
+
+  VALUE klass;
+  VALUE location;
+  VALUE name;
+  VALUE type;
+
+  switch (state->current_token.type)
+  {
+  case tAIDENT:
+    klass = RBS_AST_Members_InstanceVariable;
+
+    name_range = state->current_token.range;
+    name = ID2SYM(INTERN_TOKEN(state, state->current_token));
+
+    parser_advance_assert(state, pCOLON);
+    colon_range = state->current_token.range;
+
+    type = parse_type(state);
+    member_range.end = state->current_token.range.end;
+
+    break;
+
+  case tA2IDENT:
+    klass = RBS_AST_Members_ClassVariable;
+
+    name_range = state->current_token.range;
+    name = ID2SYM(INTERN_TOKEN(state, state->current_token));
+
+    parser_advance_assert(state, pCOLON);
+    colon_range = state->current_token.range;
+
+    parser_push_typevar_table(state, true);
+    type = parse_type(state);
+    parser_pop_typevar_table(state);
+    member_range.end = state->current_token.range.end;
+
+    break;
+
+  case kSELF:
+    klass = RBS_AST_Members_ClassInstanceVariable;
+
+    kind_range.start = state->current_token.range.start;
+    kind_range.end = state->next_token.range.end;
+
+    parser_advance_assert(state, pDOT);
+    parser_advance_assert(state, tAIDENT);
+
+    name_range = state->current_token.range;
+    name = ID2SYM(INTERN_TOKEN(state, state->current_token));
+
+    parser_advance_assert(state, pCOLON);
+    colon_range = state->current_token.range;
+
+    parser_push_typevar_table(state, true);
+    type = parse_type(state);
+    parser_pop_typevar_table(state);
+    member_range.end = state->current_token.range.end;
+
+    break;
+
+  default:
+    rbs_abort();
+  }
+
+  location = rbs_new_location(state->buffer, member_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range);
+  rbs_loc_add_optional_child(loc, rb_intern("kind"), kind_range);
+
+  return rbs_ast_members_variable(klass, name, type, location, comment);
+}
+
+/*
+  visibility_member ::= {<`public`>}
+                      | {<`private`>}
+*/
+VALUE parse_visibility_member(parserstate *state, VALUE annotations) {
+  if (rb_array_len(annotations) > 0) {
+    raise_syntax_error(
+      state,
+      state->current_token,
+      "annotation cannot be given to visibility members"
+    );
+  }
+
+  VALUE klass;
+
+  switch (state->current_token.type)
+  {
+  case kPUBLIC:
+    klass = RBS_AST_Members_Public;
+    break;
+  case kPRIVATE:
+    klass = RBS_AST_Members_Private;
+    break;
+  default:
+    rbs_abort();
+  }
+
+  return rbs_ast_members_visibility(
+    klass,
+    rbs_new_location(state->buffer, state->current_token.range)
+  );
+}
+
+/*
+  attribute_member ::= {attr_keyword} attr_name attr_var `:` <type>
+                     | {visibility} attr_keyword attr_name attr_var `:` <type>
+                     | {attr_keyword} `self` `.` attr_name attr_var `:` <type>
+                     | {visibility} attr_keyword `self` `.` attr_name attr_var `:` <type>
+
+  attr_keyword ::= `attr_reader` | `attr_writer` | `attr_accessor`
+
+  visibility ::= `public` | `private`
+
+  attr_var ::=                    # empty
+             | `(` tAIDENT `)`    # Ivar name
+             | `(` `)`            # No variable
+*/
+VALUE parse_attribute_member(parserstate *state, position comment_pos, VALUE annotations) {
+  range member_range;
+  range keyword_range, name_range, colon_range;
+  range kind_range = NULL_RANGE, ivar_range = NULL_RANGE, ivar_name_range = NULL_RANGE, visibility_range = NULL_RANGE;
+
+  InstanceSingletonKind is_kind;
+  VALUE klass;
+  VALUE kind;
+  VALUE attr_name;
+  VALUE ivar_name;
+  VALUE type;
+  VALUE comment;
+  VALUE location;
+  VALUE visibility;
+  rbs_loc *loc;
+
+  member_range.start = state->current_token.range.start;
+  comment_pos = nonnull_pos_or(comment_pos, member_range.start);
+  comment = get_comment(state, comment_pos.line);
+
+  switch (state->current_token.type)
+  {
+  case kPRIVATE:
+    visibility = ID2SYM(rb_intern("private"));
+    visibility_range = state->current_token.range;
+    parser_advance(state);
+    break;
+  case kPUBLIC:
+    visibility = ID2SYM(rb_intern("public"));
+    visibility_range = state->current_token.range;
+    parser_advance(state);
+    break;
+  default:
+    visibility = Qnil;
+    visibility_range = NULL_RANGE;
+    break;
+  }
+
+  keyword_range = state->current_token.range;
+  switch (state->current_token.type)
+  {
+  case kATTRREADER:
+    klass = RBS_AST_Members_AttrReader;
+    break;
+  case kATTRWRITER:
+    klass = RBS_AST_Members_AttrWriter;
+    break;
+  case kATTRACCESSOR:
+    klass = RBS_AST_Members_AttrAccessor;
+    break;
+  default:
+    rbs_abort();
+  }
+
+  is_kind = parse_instance_singleton_kind(state, false, &kind_range);
+  if (is_kind == INSTANCE_KIND) {
+    kind = ID2SYM(rb_intern("instance"));
+  } else {
+    kind = ID2SYM(rb_intern("singleton"));
+  }
+
+  attr_name = parse_method_name(state, &name_range);
+
+  if (state->next_token.type == pLPAREN) {
+    parser_advance_assert(state, pLPAREN);
+    ivar_range.start = state->current_token.range.start;
+
+    if (parser_advance_if(state, tAIDENT)) {
+      ivar_name = ID2SYM(INTERN_TOKEN(state, state->current_token));
+      ivar_name_range = state->current_token.range;
+    } else {
+      ivar_name = Qfalse;
+    }
+
+    parser_advance_assert(state, pRPAREN);
+    ivar_range.end = state->current_token.range.end;
+  } else {
+    ivar_name = Qnil;
+  }
+
+  parser_advance_assert(state, pCOLON);
+  colon_range = state->current_token.range;
+
+  parser_push_typevar_table(state, is_kind == SINGLETON_KIND);
+  type = parse_type(state);
+  parser_pop_typevar_table(state);
+  member_range.end = state->current_token.range.end;
+
+  location = rbs_new_location(state->buffer, member_range);
+  loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range);
+  rbs_loc_add_optional_child(loc, rb_intern("kind"), kind_range);
+  rbs_loc_add_optional_child(loc, rb_intern("ivar"), ivar_range);
+  rbs_loc_add_optional_child(loc, rb_intern("ivar_name"), ivar_name_range);
+  rbs_loc_add_optional_child(loc, rb_intern("visibility"), visibility_range);
+
+  return rbs_ast_members_attribute(
+    klass,
+    attr_name,
+    type,
+    ivar_name,
+    kind,
+    annotations,
+    location,
+    comment,
+    visibility
+  );
+}
+
+/*
+  interface_members ::= {} ...<interface_member> kEND
+
+  interface_member ::= def_member     (instance method only && no overloading)
+                     | mixin_member   (interface only)
+                     | alias_member   (instance only)
+*/
+VALUE parse_interface_members(parserstate *state) {
+  VALUE members = rb_ary_new();
+
+  while (state->next_token.type != kEND) {
+    VALUE annotations = rb_ary_new();
+    position annot_pos = NullPosition;
+
+    parse_annotations(state, annotations, &annot_pos);
+
+    parser_advance(state);
+
+    VALUE member;
+    switch (state->current_token.type) {
+    case kDEF:
+      member = parse_member_def(state, true, true, annot_pos, annotations);
+      break;
+
+    case kINCLUDE:
+    case kEXTEND:
+    case kPREPEND:
+      member = parse_mixin_member(state, true, annot_pos, annotations);
+      break;
+
+    case kALIAS:
+      member = parse_alias_member(state, true, annot_pos, annotations);
+      break;
+
+    default:
+      raise_syntax_error(
+        state,
+        state->current_token,
+        "unexpected token for interface declaration member"
+      );
+    }
+
+    rb_ary_push(members, member);
+  }
+
+  return members;
+}
+
+/*
+  interface_decl ::= {`interface`} interface_name module_type_params interface_members <kEND>
+*/
+VALUE parse_interface_decl(parserstate *state, position comment_pos, VALUE annotations) {
+  range member_range;
+  range name_range, keyword_range, end_range;
+  range type_params_range = NULL_RANGE;
+
+  member_range.start = state->current_token.range.start;
+  comment_pos = nonnull_pos_or(comment_pos, member_range.start);
+
+  parser_push_typevar_table(state, true);
+  keyword_range = state->current_token.range;
+
+  parser_advance(state);
+
+  VALUE name = parse_type_name(state, INTERFACE_NAME, &name_range);
+  VALUE params = parse_type_params(state, &type_params_range, true);
+  VALUE members = parse_interface_members(state);
+
+  parser_advance_assert(state, kEND);
+  end_range = state->current_token.range;
+  member_range.end = end_range.end;
+
+  parser_pop_typevar_table(state);
+
+  VALUE location = rbs_new_location(state->buffer, member_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("end"), end_range);
+  rbs_loc_add_optional_child(loc, rb_intern("type_params"), type_params_range);
+
+  return rbs_ast_decl_interface(
+    name,
+    params,
+    members,
+    annotations,
+    location,
+    get_comment(state, comment_pos.line)
+  );
+}
+
+/*
+  module_self_types ::= {`:`} module_self_type `,` ... `,` <module_self_type>
+
+  module_self_type ::= <module_name>
+                     | module_name `[` type_list <`]`>
+*/
+void parse_module_self_types(parserstate *state, VALUE array) {
+  while (true) {
+    range self_range;
+    range name_range;
+    range args_range = NULL_RANGE;
+
+    parser_advance(state);
+
+    self_range.start = state->current_token.range.start;
+
+    VALUE module_name = parse_type_name(state, CLASS_NAME | INTERFACE_NAME, &name_range);
+    self_range.end = name_range.end;
+
+    VALUE args = rb_ary_new();
+    if (state->next_token.type == pLBRACKET) {
+      parser_advance(state);
+      args_range.start = state->current_token.range.start;
+      parse_type_list(state, pRBRACKET, args);
+      parser_advance(state);
+      self_range.end = args_range.end = state->current_token.range.end;
+    }
+
+    VALUE location = rbs_new_location(state->buffer, self_range);
+    rbs_loc *loc = rbs_check_location(location);
+    rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+    rbs_loc_add_optional_child(loc, rb_intern("args"), args_range);
+
+    VALUE self_type = rbs_ast_decl_module_self(module_name, args, location);
+    rb_ary_push(array, self_type);
+
+    if (state->next_token.type == pCOMMA) {
+      parser_advance(state);
+    } else {
+      break;
+    }
+  }
+}
+
+VALUE parse_nested_decl(parserstate *state, const char *nested_in, position annot_pos, VALUE annotations);
+
+/*
+  module_members ::= {} ...<module_member> kEND
+
+  module_member ::= def_member
+                  | variable_member
+                  | mixin_member
+                  | alias_member
+                  | attribute_member
+                  | `public`
+                  | `private`
+*/
+VALUE parse_module_members(parserstate *state) {
+  VALUE members = rb_ary_new();
+
+  while (state->next_token.type != kEND) {
+    VALUE member;
+    VALUE annotations = rb_ary_new();
+    position annot_pos = NullPosition;
+
+    parse_annotations(state, annotations, &annot_pos);
+
+    parser_advance(state);
+
+    switch (state->current_token.type)
+    {
+    case kDEF:
+      member = parse_member_def(state, false, true, annot_pos, annotations);
+      break;
+
+    case kINCLUDE:
+    case kEXTEND:
+    case kPREPEND:
+      member = parse_mixin_member(state, false, annot_pos, annotations);
+      break;
+
+    case kALIAS:
+      member = parse_alias_member(state, false, annot_pos, annotations);
+      break;
+
+    case tAIDENT:
+    case tA2IDENT:
+    case kSELF:
+      member = parse_variable_member(state, annot_pos, annotations);
+      break;
+
+    case kATTRREADER:
+    case kATTRWRITER:
+    case kATTRACCESSOR:
+      member = parse_attribute_member(state, annot_pos, annotations);
+      break;
+
+    case kPUBLIC:
+    case kPRIVATE:
+      if (state->next_token.range.start.line == state->current_token.range.start.line) {
+        switch (state->next_token.type)
+        {
+        case kDEF:
+          member = parse_member_def(state, false, true, annot_pos, annotations);
+          break;
+        case kATTRREADER:
+        case kATTRWRITER:
+        case kATTRACCESSOR:
+          member = parse_attribute_member(state, annot_pos, annotations);
+          break;
+        default:
+          raise_syntax_error(state, state->next_token, "method or attribute definition is expected after visibility modifier");
+        }
+      } else {
+        member = parse_visibility_member(state, annotations);
+      }
+      break;
+
+    default:
+      member = parse_nested_decl(state, "module", annot_pos, annotations);
+      break;
+    }
+
+    rb_ary_push(members, member);
+  }
+
+  return members;
+}
+
+/*
+  module_decl ::= {`module`} module_name module_type_params module_members <kEND>
+                | {`module`} module_name module_type_params `:` module_self_types module_members <kEND>
+*/
+VALUE parse_module_decl(parserstate *state, position comment_pos, VALUE annotations) {
+  range decl_range;
+  range keyword_range;
+  range name_range;
+  range end_range;
+  range type_params_range;
+  range colon_range;
+  range self_types_range;
+
+  parser_push_typevar_table(state, true);
+
+  position start = state->current_token.range.start;
+  comment_pos = nonnull_pos_or(comment_pos, start);
+  VALUE comment = get_comment(state, comment_pos.line);
+
+  keyword_range = state->current_token.range;
+  decl_range.start = state->current_token.range.start;
+
+  parser_advance(state);
+  VALUE module_name = parse_type_name(state, CLASS_NAME, &name_range);
+  VALUE type_params = parse_type_params(state, &type_params_range, true);
+  VALUE self_types = rb_ary_new();
+
+  if (state->next_token.type == pCOLON) {
+    parser_advance(state);
+    colon_range = state->current_token.range;
+    self_types_range.start = state->next_token.range.start;
+    parse_module_self_types(state, self_types);
+    self_types_range.end = state->current_token.range.end;
+  } else {
+    colon_range = NULL_RANGE;
+    self_types_range = NULL_RANGE;
+  }
+
+  VALUE members = parse_module_members(state);
+
+  parser_advance_assert(state, kEND);
+  end_range = state->current_token.range;
+  decl_range.end = state->current_token.range.end;
+
+  VALUE location = rbs_new_location(state->buffer, decl_range);
+  rbs_loc *loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("end"), end_range);
+  rbs_loc_add_optional_child(loc, rb_intern("type_params"), type_params_range);
+  rbs_loc_add_optional_child(loc, rb_intern("colon"), colon_range);
+  rbs_loc_add_optional_child(loc, rb_intern("self_types"), self_types_range);
+
+  parser_pop_typevar_table(state);
+
+  return rbs_ast_decl_module(
+    module_name,
+    type_params,
+    self_types,
+    members,
+    annotations,
+    location,
+    comment
+  );
+}
+
+/*
+  class_decl_super ::= {} `<` <class_instance_name>
+                     | {<>}
+*/
+VALUE parse_class_decl_super(parserstate *state, range *lt_range) {
+  if (parser_advance_if(state, pLT)) {
+    range super_range;
+    range name_range;
+    range args_range = NULL_RANGE;
+
+    VALUE name;
+    VALUE args;
+    VALUE location;
+    rbs_loc *loc;
+
+    *lt_range = state->current_token.range;
+    super_range.start = state->next_token.range.start;
+
+    args = rb_ary_new();
+    class_instance_name(state, CLASS_NAME, &name, args, &name_range, &args_range);
+
+    super_range.end = args_range.end;
+
+    location = rbs_new_location(state->buffer, super_range);
+    loc = rbs_check_location(location);
+    rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+    rbs_loc_add_optional_child(loc, rb_intern("args"), args_range);
+
+    return rbs_ast_decl_class_super(name, args, location);
+  } else {
+    *lt_range = NULL_RANGE;
+    return Qnil;
+  }
+}
+
+/*
+  class_decl ::= {`class`} class_name type_params class_decl_super class_members <`end`>
+*/
+VALUE parse_class_decl(parserstate *state, position comment_pos, VALUE annotations) {
+  range decl_range;
+  range keyword_range;
+  range name_range;
+  range end_range;
+  range type_params_range;
+  range lt_range;
+
+  VALUE name;
+  VALUE type_params;
+  VALUE super;
+  VALUE members;
+  VALUE comment;
+  VALUE location;
+
+  rbs_loc *loc;
+
+  parser_push_typevar_table(state, true);
+
+  decl_range.start = state->current_token.range.start;
+  keyword_range = state->current_token.range;
+
+  comment_pos = nonnull_pos_or(comment_pos, decl_range.start);
+  comment = get_comment(state, comment_pos.line);
+
+  parser_advance(state);
+  name = parse_type_name(state, CLASS_NAME, &name_range);
+  type_params = parse_type_params(state, &type_params_range, true);
+  super = parse_class_decl_super(state, &lt_range);
+  members = parse_module_members(state);
+  parser_advance_assert(state, kEND);
+  end_range = state->current_token.range;
+
+  decl_range.end = end_range.end;
+
+  parser_pop_typevar_table(state);
+
+  location = rbs_new_location(state->buffer, decl_range);
+  loc = rbs_check_location(location);
+  rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range);
+  rbs_loc_add_required_child(loc, rb_intern("name"), name_range);
+  rbs_loc_add_required_child(loc, rb_intern("end"), end_range);
+  rbs_loc_add_optional_child(loc, rb_intern("type_params"), type_params_range);
+  rbs_loc_add_optional_child(loc, rb_intern("lt"), lt_range);
+
+  return rbs_ast_decl_class(
+    name,
+    type_params,
+    super,
+    members,
+    annotations,
+    location,
+    comment
+  );
+}
+
+/*
+  nested_decl ::= {<const_decl>}
+                | {<class_decl>}
+                | {<interface_decl>}
+                | {<module_decl>}
+                | {<class_decl>}
+*/
+VALUE parse_nested_decl(parserstate *state, const char *nested_in, position annot_pos, VALUE annotations) {
+  VALUE decl;
+
+  parser_push_typevar_table(state, true);
+
+  switch (state->current_token.type) {
+  case tUIDENT:
+  case pCOLON2:
+    decl = parse_const_decl(state);
+    break;
+  case tGIDENT:
+    decl = parse_global_decl(state);
+    break;
+  case kTYPE:
+    decl = parse_type_decl(state, annot_pos, annotations);
+    break;
+  case kINTERFACE:
+    decl = parse_interface_decl(state, annot_pos, annotations);
+    break;
+  case kMODULE:
+    decl = parse_module_decl(state, annot_pos, annotations);
+    break;
+  case kCLASS:
+    decl = parse_class_decl(state, annot_pos, annotations);
+    break;
+  default:
+    raise_syntax_error(
+      state,
+      state->current_token,
+      "unexpected token for class/module declaration member"
+    );
+  }
+
+  parser_pop_typevar_table(state);
+
+  return decl;
+}
+
+VALUE parse_decl(parserstate *state) {
+  VALUE annotations = rb_ary_new();
+  position annot_pos = NullPosition;
+
+  parse_annotations(state, annotations, &annot_pos);
+
+  parser_advance(state);
+  switch (state->current_token.type) {
+  case tUIDENT:
+  case pCOLON2:
+    return parse_const_decl(state);
+  case tGIDENT:
+    return parse_global_decl(state);
+  case kTYPE:
+    return parse_type_decl(state, annot_pos, annotations);
+  case kINTERFACE:
+    return parse_interface_decl(state, annot_pos, annotations);
+  case kMODULE:
+    return parse_module_decl(state, annot_pos, annotations);
+  case kCLASS:
+    return parse_class_decl(state, annot_pos, annotations);
+  default:
+    raise_syntax_error(
+      state,
+      state->current_token,
+      "cannot start a declaration"
+    );
+  }
+}
+
+VALUE parse_signature(parserstate *state) {
+  VALUE decls = rb_ary_new();
+
+  while (state->next_token.type != pEOF) {
+    rb_ary_push(decls, parse_decl(state));
+  }
+
+  return decls;
+}
+
+static VALUE
+rbsparser_parse_type(VALUE self, VALUE buffer, VALUE start_pos, VALUE end_pos, VALUE variables, VALUE requires_eof)
+{
+  parserstate *parser = alloc_parser(buffer, FIX2INT(start_pos), FIX2INT(end_pos), variables);
+
+  if (parser->next_token.type == pEOF) {
+    return Qnil;
+  }
+
+  VALUE type = parse_type(parser);
+
+  if (RTEST(requires_eof)) {
+    parser_advance_assert(parser, pEOF);
+  }
+
+  free_parser(parser);
+
+  return type;
+}
+
+static VALUE
+rbsparser_parse_method_type(VALUE self, VALUE buffer, VALUE start_pos, VALUE end_pos, VALUE variables, VALUE requires_eof)
+{
+  parserstate *parser = alloc_parser(buffer, FIX2INT(start_pos), FIX2INT(end_pos), variables);
+
+  if (parser->next_token.type == pEOF) {
+    return Qnil;
+  }
+
+  VALUE method_type = parse_method_type(parser);
+
+  if (RTEST(requires_eof)) {
+    parser_advance_assert(parser, pEOF);
+  }
+
+  free_parser(parser);
+
+  return method_type;
+}
+
+static VALUE
+rbsparser_parse_signature(VALUE self, VALUE buffer, VALUE end_pos)
+{
+  parserstate *parser = alloc_parser(buffer, 0, FIX2INT(end_pos), Qnil);
+  VALUE signature = parse_signature(parser);
+  free_parser(parser);
+
+  return signature;
+}
+
+void rbs__init_parser(void) {
+  RBS_Parser = rb_define_class_under(RBS, "Parser", rb_cObject);
+  rb_define_singleton_method(RBS_Parser, "_parse_type", rbsparser_parse_type, 5);
+  rb_define_singleton_method(RBS_Parser, "_parse_method_type", rbsparser_parse_method_type, 5);
+  rb_define_singleton_method(RBS_Parser, "_parse_signature", rbsparser_parse_signature, 2);
+}