MetadataDeclarationHelper.h

/*
 * GDevelop Core
 * Copyright 2008-2023 Florian Rival ([email protected]). All rights
 * reserved. This project is released under the MIT License.
 */
#pragma once
 
#include "GDCore/String.h"
#include <functional>
#include <map>
#include <memory>
#include <vector>
 
 
namespace gd {
class PlatformExtension;
class Project;
class EventsFunctionsExtension;
class EventsBasedBehavior;
class BehaviorMetadata;
class EventsBasedObject;
class ObjectMetadata;
class EventsFunction;
class PropertyDescriptor;
class EventsFunctionsContainer;
class AbstractFunctionMetadata;
class InstructionOrExpressionContainerMetadata;
class AbstractEventsBasedEntity;
class NamedPropertyDescriptor;
class ParameterMetadata;
class InstructionMetadata;
class ExpressionMetadata;
class MultipleInstructionMetadata;
} // namespace gd
 
namespace gdjs {
 
class MetadataDeclarationHelper {
public:
  MetadataDeclarationHelper(){};
  virtual ~MetadataDeclarationHelper(){};
 
  gd::AbstractFunctionMetadata &GenerateFreeFunctionMetadata(
      const gd::Project &project, gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension,
      const gd::EventsFunction &eventsFunction);
 
  static gd::BehaviorMetadata &GenerateBehaviorMetadata(
      const gd::Project &project, gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension,
      const gd::EventsBasedBehavior &eventsBasedBehavior,
      std::map<gd::String, gd::String> &behaviorMethodMangledNames);
 
  static gd::ObjectMetadata &GenerateObjectMetadata(
      gd::Project &project, gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension,
      const gd::EventsBasedObject &eventsBasedObject,
      std::map<gd::String, gd::String> &objectMethodMangledNames);
 
  static gd::String GetExtensionCodeNamespacePrefix(
      const gd::EventsFunctionsExtension &eventsFunctionsExtension);
 
  static gd::String GetFreeFunctionCodeName(
      const gd::EventsFunctionsExtension &eventsFunctionsExtension,
      const gd::EventsFunction &eventsFunction);
 
  static gd::String
  GetFreeFunctionCodeNamespace(const gd::EventsFunction &eventsFunction,
                               const gd::String &codeNamespacePrefix);
 
  static gd::String GetBehaviorFunctionCodeNamespace(
      const gd::EventsBasedBehavior &eventsBasedBehavior,
      const gd::String &codeNamespacePrefix);
 
  static gd::String
  GetObjectFunctionCodeNamespace(const gd::EventsBasedObject &eventsBasedObject,
                                 const gd::String &codeNamespacePrefix);
 
  static void DeclareExtension(
      gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension);
 
  static bool IsBehaviorLifecycleEventsFunction(const gd::String &functionName);
 
  static bool IsObjectLifecycleEventsFunction(const gd::String &functionName);
 
  static bool
  IsExtensionLifecycleEventsFunction(const gd::String &functionName);
 
  static gd::String ShiftSentenceParamIndexes(const gd::String &sentence,
                                              const int offset);
 
private:
  static const gd::String &
  GetExtensionIconUrl(const gd::PlatformExtension &extension);
 
  static const gd::String &
  GetEntityIconUrl(const gd::PlatformExtension &extension,
                     const gd::AbstractEventsBasedEntity &eventsBasedEntity);
 
  static void DeclareExtensionDependencies(
      gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension);
 
  static void DeclarePropertyInstructionAndExpression(
      gd::PlatformExtension &extension,
      gd::InstructionOrExpressionContainerMetadata &entityMetadata,
      const gd::AbstractEventsBasedEntity &eventsBasedEntity,
      const gd::NamedPropertyDescriptor &property,
      const gd::String &propertyLabel, const gd::String &expressionName,
      const gd::String &conditionName, const gd::String &actionName,
      const gd::String &toggleActionName, const gd::String &setterName,
      const gd::String &getterName, const gd::String &toggleFunctionName,
      const int valueParameterIndex,
      std::function<gd::AbstractFunctionMetadata &(
          gd::AbstractFunctionMetadata &instructionOrExpression)>
          addObjectAndBehaviorParameters,
      bool isSharedProperty);
 
  static void DeclareBehaviorPropertiesInstructionAndExpressions(
      gd::PlatformExtension &extension, gd::BehaviorMetadata &behaviorMetadata,
      const gd::EventsBasedBehavior &eventsBasedBehavior);
 
  static void DeclareObjectPropertiesInstructionAndExpressions(
      gd::PlatformExtension &extension, gd::ObjectMetadata &objectMetadata,
      const gd::EventsBasedObject &eventsBasedObject);
 
  static void DeclareObjectInternalInstructions(
      gd::PlatformExtension &extension, gd::ObjectMetadata &objectMetadata,
      const gd::EventsBasedObject &eventsBasedObject);
 
  static const gd::String defaultExtensionIconPath;
 
  static gd::BehaviorMetadata &
  DeclareBehaviorMetadata(const gd::Project &project,
                          gd::PlatformExtension &extension,
                          const gd::EventsBasedBehavior &eventsBasedBehavior);
 
  static gd::ObjectMetadata &
  DeclareObjectMetadata(gd::PlatformExtension &extension,
                        const gd::EventsBasedObject &eventsBasedObject);
 
  static void
  AddParameter(gd::AbstractFunctionMetadata &instructionOrExpression,
               const gd::ParameterMetadata &parameter);
 
  gd::AbstractFunctionMetadata &DeclareInstructionOrExpressionMetadata(
      gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension,
      const gd::EventsFunction &eventsFunction);
 
  gd::AbstractFunctionMetadata &DeclareExpressionMetadata(
      gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension,
      const gd::EventsFunction &eventsFunction);
 
  static gd::InstructionMetadata &DeclareInstructionMetadata(
      gd::PlatformExtension &extension,
      const gd::EventsFunctionsExtension &eventsFunctionsExtension,
      const gd::EventsFunction &eventsFunction);
 
  gd::AbstractFunctionMetadata &DeclareBehaviorInstructionOrExpressionMetadata(
      gd::PlatformExtension &extension, gd::BehaviorMetadata &behaviorMetadata,
      const gd::EventsBasedBehavior &eventsBasedBehavior,
      const gd::EventsFunction &eventsFunction,
      std::map<gd::String, gd::String> &objectMethodMangledNames);
 
  gd::AbstractFunctionMetadata &DeclareBehaviorExpressionMetadata(
      gd::PlatformExtension &extension, gd::BehaviorMetadata &behaviorMetadata,
      const gd::EventsBasedBehavior &eventsBasedBehavior,
      const gd::EventsFunction &eventsFunction);
 
  static gd::InstructionMetadata &DeclareBehaviorInstructionMetadata(
      gd::PlatformExtension &extension, gd::BehaviorMetadata &behaviorMetadata,
      const gd::EventsBasedBehavior &eventsBasedBehavior,
      const gd::EventsFunction &eventsFunction);
 
  gd::AbstractFunctionMetadata &DeclareObjectInstructionOrExpressionMetadata(
      gd::PlatformExtension &extension, gd::ObjectMetadata &objectMetadata,
      const gd::EventsBasedObject &eventsBasedObject,
      const gd::EventsFunction &eventsFunction,
      std::map<gd::String, gd::String> &objectMethodMangledNames);
 
  gd::AbstractFunctionMetadata &DeclareObjectExpressionMetadata(
      gd::PlatformExtension &extension, gd::ObjectMetadata &objectMetadata,
      const gd::EventsBasedObject &eventsBasedObject,
      const gd::EventsFunction &eventsFunction);
 
  static gd::InstructionMetadata &DeclareObjectInstructionMetadata(
      gd::PlatformExtension &extension, gd::ObjectMetadata &objectMetadata,
      const gd::EventsBasedObject &eventsBasedObject,
      const gd::EventsFunction &eventsFunction);
 
  static void DeclareEventsFunctionParameters(
      const gd::EventsFunctionsContainer &eventsFunctionsContainer,
      const gd::EventsFunction &eventsFunction,
      gd::ExpressionMetadata &expression,
      const int userDefinedFirstParameterIndex);
 
  static void DeclareEventsFunctionParameters(
      const gd::EventsFunctionsContainer &eventsFunctionsContainer,
      const gd::EventsFunction &eventsFunction,
      gd::InstructionMetadata &instruction,
      const int userDefinedFirstParameterIndex);
 
  static void DeclareEventsFunctionParameters(
      const gd::EventsFunctionsContainer &eventsFunctionsContainer,
      const gd::EventsFunction &eventsFunction,
      gd::MultipleInstructionMetadata &multipleInstructionMetadata,
      const int userDefinedFirstParameterIndex);
 
  static void
  UpdateCustomObjectDefaultBehaviors(gd::Project &project,
                                     const gd::ObjectMetadata &objectMetadata);
 
  static gd::String RemoveTrailingDot(const gd::String &description);
 
  static gd::String
  GetStringifiedExtraInfo(const gd::PropertyDescriptor &property);
 
  static gd::String UncapitalizeFirstLetter(const gd::String &string);
 
  static gd::String GetFullName(const gd::EventsFunction &eventsFunction);
  static gd::String GetDefaultSentence(const gd::EventsFunction &eventsFunction,
                                       const int firstParameterIndex,
                                       const int parameterIndexOffset);
  static gd::String
  GetFreeFunctionSentence(const gd::EventsFunction &eventsFunction);
  static gd::String
  GetBehaviorFunctionSentence(const gd::EventsFunction &eventsFunction,
                              const bool excludeObjectParameter = false);
  static gd::String
  GetObjectFunctionSentence(const gd::EventsFunction &eventsFunction,
                            const bool excludeObjectParameter = false);
 
  std::vector<gd::MultipleInstructionMetadata> expressionAndConditions;
};
 
} // namespace gdjs