====== Kontrolni seznam VSCode Extension ======

Specifična preverjanja za VSCode razširitve s pas2js.

<note>Ta kontrolni seznam dopolnjuje [[.:audit-core|Kontrolni seznam Core]] za VSCode razširitve.</note>

===== Obvezna preverjanja =====

==== Activation Events ====

<code>
[ ] Activation Events so minimalni in pravilni
[ ] Brez "activate on *" razen če je utemeljeno
[ ] Dogodki ustrezajo dejanski funkcionalnosti
</code>

**Primer package.json:**

<code javascript>
{
  "activationEvents": [
    "onCommand:wvds.build.run",
    "onLanguage:pascal",
    "workspaceContains:**/*.lpr"
  ]
}
</code>

==== Zmogljivost ====

<code>
[ ] Brez dolgotrajnih operacij na niti Extension Host
[ ] Asinhrono delo je prekinjljivo (Cancellation Token)
[ ] Poročanje o napredku za dolge operacije
</code>

**Primer: Prekinjljiva operacija:**

<code pascal>
procedure LongOperation(AToken: TCancellationToken);
begin
  while not Finished do
  begin
    if AToken.IsCancellationRequested then
    begin
      Logger.Info(rsOperationCancelled);
      Exit;
    end;
    ProcessNextItem;
  end;
end;
</code>

==== Commands ====

<code>
[ ] Commands imajo konsistentne ID-je
[ ] Vsi Commands imajo naslov in kategorijo
[ ] Grupiranje Commands je logično
</code>

**Konvencija poimenovanja:**

<code>
wvds.<domena>.<akcija>
  +-- wvds.build.run
  +-- wvds.build.clean
  +-- wvds.projects.create
</code>

==== Settings ====

<code>
[ ] Vse Settings v contributes.configuration
[ ] Settings so dokumentirane (description)
[ ] Settings imajo varne privzete vrednosti
[ ] Settings so validirane
</code>

**Primer:**

<code javascript>
{
  "contributes": {
    "configuration": {
      "title": "WvdS Toolchain",
      "properties": {
        "wvds.toolchain.fpcPath": {
          "type": "string",
          "default": "",
          "description": "Path to fpc.exe. Leave empty for auto-detection."
        }
      }
    }
  }
}
</code>

==== Varnost ====

<code>
[ ] Klici zunanjih orodij validirani/sanirani
[ ] Poti workspace obravnavane kot nezaupanja vredne
[ ] Command Injection ni mogoč
[ ] shell: false pri klicih Spawn
</code>

**Primer: Varen klic orodja:**

<code pascal>
(* PREPOVEDANO - Mogoč Command Injection *)
Exec('fpc ' + UserInput);

(* PRAVILNO - Varna alternativa *)
var
  Options: TSpawnOptions;
begin
  Options.shell := False;
  Options.cwd := ValidatedPath;
  Spawn('fpc', ['-O2', ValidatedInput], Options);
end;
</code>

==== Cross-Platform ====

<code>
[ ] Poti so cross-platform varne
[ ] Kodiranja upoštevana (UTF-8)
[ ] Končnice vrstic upoštevane
[ ] Ločila poti pravilna (uporaba PathJoin)
</code>

==== package.json Metadata ====

<code>
[ ] publisher nastavljeno
[ ] name pravilno (male črke, vezaji)
[ ] version sledi SemVer
[ ] license navedena
[ ] repository povezan
[ ] engines.vscode na minimalno verzijo
</code>

==== Marketplace Assets ====

<code>
[ ] README.md prisoten in ažuren
[ ] CHANGELOG.md z zgodovino verzij
[ ] Ikona prisotna (128x128 PNG)
[ ] Posnetki zaslona za kompleksne funkcije
</code>

===== pas2js-specifična preverjanja =====

==== Kompilacija ====

<code>
[ ] Kompilira brez napak s pas2js
[ ] Brez pas2js-nezdružljivih funkcij
[ ] Brez class var (namesto tega Unit-Level Variable)
[ ] Brez Int64 (namesto tega Integer)
[ ] Brez // komentarjev v asm-blokih
</code>

==== Entry Point Pattern ====

<code>
[ ] extension_main.pas prisoten
[ ] Activate/Deactivate izvožena
[ ] Initialization-blok kliče ExportActivateDeactivate
</code>

**Predloga:**

<code pascal>
unit extension_main;

{$mode objfpc}{$H+}

interface

uses
  JS, VSCode.API, WvdS.VSCode.ExtensionExports;

procedure Activate(AContext: TExtensionContext);
procedure Deactivate;

implementation

procedure Activate(AContext: TExtensionContext);
begin
  (* Inicializacija *)
end;

procedure Deactivate;
begin
  (* Čiščenje *)
end;

initialization
  ExportActivateDeactivate(@Activate, @Deactivate);

end.
</code>

==== SSOT za VSCode API-je ====

<code>
[ ] VSCode API-ji prek ~/sources/common/web/vscode/
[ ] Brez neposrednega require('vscode') v razširitvah
[ ] Uporabljene ovojnice WvdS.VSCode.*
</code>

===== Priporočena preverjanja =====

<code>
[ ] Progress Reporting za operacije > 1s
[ ] Cancellation Tokens implementirani
[ ] Debouncing pri File Watching
[ ] Velikost razširitve minimizirana
[ ] Brez nepotrebnih binarnih datotek/sredstev
</code>

===== Izbirna preverjanja =====

<code>
[ ] Smoke Tests (Activation + Command)
[ ] Offline način, če se uporabljajo oddaljene storitve
[ ] Telemetrija dokumentirana (ali brez nje)
</code>

===== Ustvarjanje VSIX =====

==== Postopek gradnje ====

<code bash>
# 1. Pascal v JavaScript kompilirati
pas2js @../../common/wvds_common.pas2js.cfg @build.cfg pas/extension_main.pas

# 2. VSIX zapakirati
vsce package --no-dependencies

# 3. Validirati
vsce ls
</code>

==== Pred ustvarjanjem VSIX preveriti ====

<code>
[ ] dist/extension_main.js prisoten
[ ] package.json version povišana
[ ] CHANGELOG.md posodobljen
[ ] README.md ažuren
[ ] Brez razhroščevalnih artefaktov
[ ] .vscodeignore pravilno konfiguriran
</code>

===== Hitri kontrolni seznam za kopiranje =====

<code>
Kontrolni seznam pregleda (VSCode Extension):

Obvezno:
- [ ] Minimalni Activation Events
- [ ] Brez blokirajočih operacij
- [ ] Commands z ID-ji, naslovi, kategorijami
- [ ] Settings dokumentirane in validirane
- [ ] Klici orodij sanirani (shell: false)
- [ ] Cross-Platform varno (poti, kodiranja)
- [ ] package.json Metadata popolna

pas2js:
- [ ] Kompilira brez napak
- [ ] Brez pas2js-nezdružljivih funkcij
- [ ] Entry Point Pattern upoštevan
- [ ] SSOT za VSCode API-je

Assets:
- [ ] README.md prisoten
- [ ] CHANGELOG.md ažuren
- [ ] Ikona prisotna
</code>

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

  * [[.:qualitaetssicherung|Pregled zagotavljanja kakovosti]]
  * [[.:audit-core|Kontrolni seznam Core]]
  * [[.:extension-entwicklung|Razvoj razširitev]]
  * [[.:code-konventionen|Konvencije kode (pas2js)]]
  * [[.:build-pipeline|Build-Pipeline]]