Spezifische Prüfungen für VSCode Extensions mit pas2js.

[ ] Activation Events sind minimal und korrekt
[ ] Kein "activate on *" außer wenn begründet
[ ] Events entsprechen tatsächlicher Funktionalität

Beispiel package.json:

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

[ ] Keine lang-laufenden Operationen auf Extension Host Thread
[ ] Async-Arbeit ist abbrechbar (Cancellation Token)
[ ] Progress-Reporting für lange Operationen

Beispiel: Cancellable Operation:

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

[ ] Commands haben konsistente IDs
[ ] Alle Commands haben Titel und Kategorie
[ ] Command-Gruppierung ist logisch

Naming Convention:

wvds.<domain>.<action>
  └── wvds.build.run
  └── wvds.build.clean
  └── wvds.projects.create

[ ] Alle Settings in contributes.configuration
[ ] Settings sind dokumentiert (description)
[ ] Settings haben sichere Defaults
[ ] Settings werden validiert

Beispiel:

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

[ ] Externe Tool-Aufrufe validiert/sanitisiert
[ ] Workspace-Pfade als untrusted behandelt
[ ] Keine Command Injection möglich
[ ] shell: false bei Spawn-Aufrufen

Beispiel: Sicherer Tool-Aufruf:

(* VERBOTEN - Command Injection möglich *)
Exec('fpc ' + UserInput);
 
(* KORREKT - Sichere Alternative *)
var
  Options: TSpawnOptions;
begin
  Options.shell := False;
  Options.cwd := ValidatedPath;
  Spawn('fpc', ['-O2', ValidatedInput], Options);
end;

[ ] Pfade sind cross-platform safe
[ ] Encodings berücksichtigt (UTF-8)
[ ] Line Endings berücksichtigt
[ ] Path-Separatoren korrekt (PathJoin verwenden)

[ ] publisher gesetzt
[ ] name korrekt (Kleinbuchstaben, Bindestriche)
[ ] version folgt SemVer
[ ] license angegeben
[ ] repository verlinkt
[ ] engines.vscode auf minimale Version gesetzt

[ ] README.md vorhanden und aktuell
[ ] CHANGELOG.md mit Version-Historie
[ ] Icon vorhanden (128x128 PNG)
[ ] Screenshots für komplexe Features

[ ] Kompiliert ohne Fehler mit pas2js
[ ] Keine pas2js-inkompatiblen Features verwendet
[ ] Keine class var (Unit-Level Variable statt)
[ ] Keine Int64 (Integer statt)
[ ] Keine // Kommentare in asm-Blöcken

[ ] extension_main.pas vorhanden
[ ] Activate/Deactivate exportiert
[ ] Initialization-Block ruft ExportActivateDeactivate auf

Template:

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
  (* Initialisierung *)
end;
 
procedure Deactivate;
begin
  (* Cleanup *)
end;
 
initialization
  ExportActivateDeactivate(@Activate, @Deactivate);
 
end.

[ ] VSCode APIs via ~/sources/common/web/vscode/
[ ] Kein direkter require('vscode') in Extensions
[ ] WvdS.VSCode.* Wrapper verwendet

[ ] Progress Reporting für Operationen > 1s
[ ] Cancellation Tokens implementiert
[ ] Debouncing bei File Watching
[ ] Extension-Größe minimiert
[ ] Keine unnötigen Binaries/Assets

[ ] Smoke Tests (Activation + Command)
[ ] Offline-Modus wenn Remote-Services genutzt
[ ] Telemetrie dokumentiert (oder keine)

# 1. Pascal zu JavaScript kompilieren
pas2js @../../common/wvds_common.pas2js.cfg @build.cfg pas/extension_main.pas
 
# 2. VSIX packen
vsce package --no-dependencies
 
# 3. Validieren
vsce ls

[ ] dist/extension_main.js vorhanden
[ ] package.json version erhöht
[ ] CHANGELOG.md aktualisiert
[ ] README.md aktuell
[ ] Keine Debug-Artefakte enthalten
[ ] .vscodeignore korrekt konfiguriert

Review-Checkliste (VSCode Extension):

Pflicht:
- [ ] Minimale Activation Events
- [ ] Keine blockierenden Operationen
- [ ] Commands mit IDs, Titeln, Kategorien
- [ ] Settings dokumentiert und validiert
- [ ] Tool-Aufrufe sanitisiert (shell: false)
- [ ] Cross-Platform safe (Pfade, Encodings)
- [ ] package.json Metadata vollständig

pas2js:
- [ ] Kompiliert ohne Fehler
- [ ] Keine pas2js-inkompatiblen Features
- [ ] Entry Point Pattern eingehalten
- [ ] SSOT für VSCode APIs

Assets:
- [ ] README.md vorhanden
- [ ] CHANGELOG.md aktuell
- [ ] Icon vorhanden

• Qualitätssicherung Übersicht
• Core-Checkliste
• Extension-Entwicklung
• Code-Konventionen (pas2js)
• Build-Pipeline