pkgs/swift2objc/lib/src/parser/parsers/parse_declarations.dart

// Copyright (c) 2024, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import '../../ast/_core/interfaces/declaration.dart';
import '../../config.dart';
import '../../context.dart';
import '../_core/parsed_symbolgraph.dart';
import '../_core/utils.dart';
import 'declaration_parsers/parse_built_in_declaration.dart';
import 'declaration_parsers/parse_compound_declaration.dart';
import 'declaration_parsers/parse_enum_declaration.dart';
import 'declaration_parsers/parse_function_declaration.dart';
import 'declaration_parsers/parse_initializer_declaration.dart';
import 'declaration_parsers/parse_typealias_declaration.dart';
import 'declaration_parsers/parse_variable_declaration.dart';

final class UnsupportedSymbolException implements Exception {
  String message;
  bool isWarning;
  UnsupportedSymbolException(this.message, {this.isWarning = false});

  @override
  String toString() => message;
}

List<Declaration> parseDeclarations(
  Context context,
  ParsedSymbolgraph symbolgraph,
) {
  final declarations = <Declaration>[];

  for (final symbol in symbolgraph.symbols.values) {
    declarations.addAll(tryParseDeclaration(context, symbol, symbolgraph));
  }

  return declarations.topLevelOnly;
}

List<Declaration> parseDeclaration(
  Context context,
  ParsedSymbol parsedSymbol,
  ParsedSymbolgraph symbolgraph,
) {
  if (parsedSymbol.declarations.isNotEmpty) {
    return parsedSymbol.declarations;
  }

  final symbolJson = parsedSymbol.json;

  final builtIn = tryParseBuiltInDeclaration(parsedSymbol);
  if (builtIn != null) {
    return parsedSymbol.declarations = [builtIn];
  }

  if (isObsoleted(symbolJson)) {
    throw ObsoleteException(parseSymbolId(symbolJson));
  }

  final symbolType = symbolJson['kind']['identifier'].get<String>();

  parsedSymbol.declarations = switch (symbolType) {
    'swift.class' => parseClassDeclaration(context, parsedSymbol, symbolgraph),
    'swift.struct' => parseStructDeclaration(
      context,
      parsedSymbol,
      symbolgraph,
    ),
    'swift.method' => [
      parseMethodDeclaration(
        context,
        parsedSymbol,
        symbolgraph,
        isStatic: false,
      ),
    ],
    'swift.type.method' => [
      parseMethodDeclaration(
        context,
        parsedSymbol,
        symbolgraph,
        isStatic: true,
      ),
    ],
    'swift.func.op' => [
      parseMethodDeclaration(
        context,
        parsedSymbol,
        symbolgraph,
        isStatic: true,
        isOperator: true,
      ),
    ],
    'swift.property' => [
      parsePropertyDeclaration(
        context,
        parsedSymbol,
        symbolgraph,
        isStatic: false,
      ),
    ],
    'swift.type.property' => [
      parsePropertyDeclaration(
        context,
        parsedSymbol,
        symbolgraph,
        isStatic: true,
      ),
    ],
    'swift.init' => [
      parseInitializerDeclaration(context, parsedSymbol, symbolgraph),
    ],
    'swift.func' => [
      parseGlobalFunctionDeclaration(context, parsedSymbol, symbolgraph),
    ],
    'swift.var' => [
      parseGlobalVariableDeclaration(context, parsedSymbol, symbolgraph),
    ],
    'swift.typealias' => [
      parseTypealiasDeclaration(context, parsedSymbol, symbolgraph),
    ],
    'swift.enum' => parseEnumDeclaration(context, parsedSymbol, symbolgraph),
    'swift.enum.case' => [
      parseEnumCaseDeclaration(context, parsedSymbol, symbolgraph),
    ],
    _ => throw UnsupportedSymbolException(
      'Symbol of type $symbolType is not supported yet: '
      '${parseSymbolId(symbolJson)}',
    ),
  };

  return parsedSymbol.declarations;
}

List<Declaration> tryParseDeclaration(
  Context context,
  ParsedSymbol parsedSymbol,
  ParsedSymbolgraph symbolgraph,
) {
  try {
    return parseDeclaration(context, parsedSymbol, symbolgraph);
  } catch (e) {
    if (parsedSymbol.source != builtInInputConfig) {
      if (e is UnsupportedSymbolException && e.isWarning) {
        context.logger.warning('$e');
      } else {
        context.logger.severe('$e');
      }
    }
  }
  return [];
}