====== Core API ======

API referenca za WvdS VSCode Core Extension.

===== Pregled =====

Core Extension zagotavlja centralne storitve, ki jih lahko uporabljajo vse druge razširitve.

<code pascal>
uses
  WvdS.Core.Services,
  WvdS.Core.Toolchain,
  WvdS.Core.Logging;
</code>

===== Storitev beleženja =====

==== LogInfo ====

<code pascal>
procedure LogInfo(const AMessage: string);
procedure LogInfo(const AFormat: string; const AArgs: array of const);
</code>

Zapiše informacijsko sporočilo v Output Channel.

==== LogWarn ====

<code pascal>
procedure LogWarn(const AMessage: string);
procedure LogWarn(const AFormat: string; const AArgs: array of const);
</code>

Zapiše opozorilo v Output Channel.

==== LogError ====

<code pascal>
procedure LogError(const AMessage: string);
procedure LogError(const AFormat: string; const AArgs: array of const);
</code>

Zapiše napako v Output Channel.

==== LogDebug ====

<code pascal>
{$IFDEF DEBUG}
procedure LogDebug(const AMessage: string);
procedure LogDebug(const AFormat: string; const AArgs: array of const);
{$ENDIF}
</code>

Zapiše razhroščevalno sporočilo. Na voljo samo pri kompilaciji z ''-dDEBUG''.

===== Storitev orodne verige =====

==== GetToolPath ====

<code pascal>
function GetToolPath(ATool: TWvdSToolType): string;
</code>

Vrne konfigurirano pot do orodja.

^ TWvdSToolType ^ Opis ^
| ttFPC | Free Pascal Compiler |
| ttPas2js | pas2js Transpiler |
| ttLazbuild | Lazarus Build Tool |
| ttInnoSetup | Inno Setup Compiler |
| ttMake | GNU Make |

**Primer:**

<code pascal>
var
  FpcPath: string;
begin
  FpcPath := GetToolPath(ttFPC);
  if FpcPath = '' then
    raise EWvdSToolNotFound.Create(rsToolNotFound);
end;
</code>

==== GetToolVersion ====

<code pascal>
function GetToolVersion(ATool: TWvdSToolType): string;
</code>

Vrne verzijo nameščenega orodja.

==== IsToolAvailable ====

<code pascal>
function IsToolAvailable(ATool: TWvdSToolType): Boolean;
</code>

Preveri, ali je orodje na voljo.

==== AutoDetectTools ====

<code pascal>
procedure AutoDetectTools;
</code>

Izvede samodejno zaznavanje vseh orodij.

===== Konfiguracija =====

==== GetConfiguration ====

<code pascal>
function GetConfiguration(const ASection: string): TJSObject;
</code>

Prebere VS Code konfiguracijo.

**Primer:**

<code pascal>
var
  Config: TJSObject;
  LogLevel: string;
begin
  Config := GetConfiguration('wvds.core');
  LogLevel := String(Config['logLevel']);
end;
</code>

==== UpdateConfiguration ====

<code pascal>
procedure UpdateConfiguration(
  const ASection: string;
  const AKey: string;
  AValue: JSValue;
  ATarget: TConfigurationTarget
);
</code>

Zapiše VS Code konfiguracijo.

^ TConfigurationTarget ^ Opis ^
| ctGlobal | Uporabniške nastavitve |
| ctWorkspace | Nastavitve delovnega prostora |
| ctWorkspaceFolder | Nastavitve mape |

===== Event-Bus =====

==== PublishEvent ====

<code pascal>
procedure PublishEvent(const AEventName: string; AData: TJSObject);
</code>

Objavi dogodek za druge razširitve.

**Primer:**

<code pascal>
var
  Data: TJSObject;
begin
  Data := TJSObject.New;
  Data['projectPath'] := ProjectPath;
  Data['success'] := True;
  PublishEvent('wvds.build.completed', Data);
end;
</code>

==== SubscribeEvent ====

<code pascal>
procedure SubscribeEvent(
  const AEventName: string;
  AHandler: TWvdSEventHandler
);
</code>

Naroči se na dogodke.

**Primer:**

<code pascal>
procedure HandleBuildCompleted(AData: TJSObject);
begin
  if Boolean(AData['success']) then
    LogInfo('Build succeeded!')
  else
    LogError('Build failed!');
end;

// Ob aktivaciji:
SubscribeEvent('wvds.build.completed', @HandleBuildCompleted);
</code>

===== Storitve UI =====

==== ShowInfoMessage ====

<code pascal>
procedure ShowInfoMessage(const AMessage: string);
function ShowInfoMessage(
  const AMessage: string;
  const AItems: array of string
): TJSPromise;  // Razreši v izbrani element
</code>

==== ShowWarningMessage ====

<code pascal>
procedure ShowWarningMessage(const AMessage: string);
</code>

==== ShowErrorMessage ====

<code pascal>
procedure ShowErrorMessage(const AMessage: string);
</code>

==== ShowQuickPick ====

<code pascal>
function ShowQuickPick(
  const AItems: array of string;
  const APlaceholder: string
): TJSPromise;
</code>

===== Storitve delovnega prostora =====

==== GetWorkspaceRoot ====

<code pascal>
function GetWorkspaceRoot: string;
</code>

Vrne pot do mape delovnega prostora.

==== GetOpenDocument ====

<code pascal>
function GetOpenDocument: string;
</code>

Vrne pot do trenutno odprtega dokumenta.

===== Glejte tudi =====

  * [[.:meta-api|Meta API]]
  * [[.:vscode-wrapper|VSCode Wrapper]]
  * [[.:extension-entwicklung|Razvoj razširitev]]