using System;

namespace MsieJavaScriptEngine

{

/// <summary>

/// Interface for the inner JS engine

/// </summary>

internal interface IInnerJsEngine : IDisposable

{

/// <summary>

/// Gets a name of JS engine mode

/// </summary>

string Mode { get; }

/// <summary>

/// Evaluates an expression

/// </summary>

/// <param name="expression">JS expression</param>

/// <param name="documentName">Document name</param>

/// <returns>Result of the expression</returns>

object Evaluate(string expression, string documentName);

/// <summary>

/// Executes a code

/// </summary>

/// <param name="code">JS code</param>

/// <param name="documentName">Document name</param>

void Execute(string code, string documentName);

/// <summary>

/// Calls a function

/// </summary>

/// <param name="functionName">Function name</param>

/// <param name="args">Function arguments</param>

/// <returns>Result of the function execution</returns>

object CallFunction(string functionName, params object[] args);

/// <summary>

/// Сhecks for the existence of a variable

/// </summary>

/// <param name="variableName">Name of variable</param>

/// <returns>Result of check (true - exists; false - not exists</returns>

bool HasVariable(string variableName);

/// <summary>

/// Gets a value of variable

/// </summary>

/// <param name="variableName">Name of variable</param>

/// <returns>Value of variable</returns>

object GetVariableValue(string variableName);

/// <summary>

/// Sets a value of variable

/// </summary>

/// <param name="variableName">Name of variable</param>

/// <param name="value">Value of variable</param>

void SetVariableValue(string variableName, object value);

/// <summary>

/// Removes a variable

/// </summary>

/// <param name="variableName">Name of variable</param>

void RemoveVariable(string variableName);

/// <summary>

/// Embeds a host object to script code

/// </summary>

/// <param name="itemName">The name for the new global variable or function that will represent the object</param>

/// <param name="value">The object to expose</param>

/// <remarks>Allows to embed instances of simple classes (or structures) and delegates.</remarks>

void EmbedHostObject(string itemName, object value);

/// <summary>

/// Embeds a host type to script code

/// </summary>

/// <param name="itemName">The name for the new global variable that will represent the type</param>

/// <param name="type">The type to expose</param>

/// <remarks>

/// Host types are exposed to script code in the form of objects whose properties and

/// methods are bound to the type's static members.

/// </remarks>

void EmbedHostType(string itemName, Type type);

/// <summary>

/// Performs a full garbage collection

/// </summary>

void CollectGarbage();

}

}