====== Meta API ======

API-Referenz für die WvdS VSCode UI Meta Extension.

===== Übersicht =====

Die Meta Extension verwaltet die Komponenten-Registry und stellt IntelliSense-Dienste bereit.

<code pascal>
uses
  WvdS.Meta.Registry,
  WvdS.Meta.IntelliSense;
</code>

===== Komponenten-Registry =====

==== RegisterComponent ====

<code pascal>
procedure RegisterComponent(const AInfo: TWvdSComponentInfo);
</code>

Registriert eine neue Komponente in der Registry.

<code pascal>
type
  TWvdSComponentInfo = record
    Name: string;           // z.B. 'Button'
    Description: string;    // Kurzbeschreibung
    Category: string;       // z.B. 'Input', 'Layout'
    Namespace: string;      // z.B. 'WvdS.UI.Controls'
    Properties: TWvdSPropertyInfoArray;
    Events: TWvdSEventInfoArray;
  end;
</code>

**Beispiel:**

<code pascal>
var
  Info: TWvdSComponentInfo;
begin
  Info.Name := 'MyButton';
  Info.Description := 'Custom button with icon';
  Info.Category := 'Input';
  Info.Namespace := 'MyApp.Controls';

  SetLength(Info.Properties, 2);
  Info.Properties[0].Name := 'Content';
  Info.Properties[0].PropType := 'string';
  Info.Properties[0].DefaultValue := '';

  Info.Properties[1].Name := 'IconPath';
  Info.Properties[1].PropType := 'string';
  Info.Properties[1].DefaultValue := '';

  RegisterComponent(Info);
end;
</code>

==== GetComponent ====

<code pascal>
function GetComponent(const AName: string): TWvdSComponentInfo;
</code>

Gibt Informationen zu einer Komponente zurück.

==== GetAllComponents ====

<code pascal>
function GetAllComponents: TWvdSComponentInfoArray;
</code>

Gibt alle registrierten Komponenten zurück.

==== GetComponentsByCategory ====

<code pascal>
function GetComponentsByCategory(const ACategory: string): TWvdSComponentInfoArray;
</code>

Gibt alle Komponenten einer Kategorie zurück.

===== Property-Informationen =====

==== TWvdSPropertyInfo ====

<code pascal>
type
  TWvdSPropertyInfo = record
    Name: string;           // Property-Name
    PropType: string;       // 'string', 'number', 'boolean', ...
    Description: string;    // Dokumentation
    DefaultValue: string;   // Standardwert
    Required: Boolean;      // Pflichtfeld?
    EnumValues: TStringArray; // Bei Enum-Typ
  end;
</code>

==== GetPropertyInfo ====

<code pascal>
function GetPropertyInfo(
  const AComponentName: string;
  const APropertyName: string
): TWvdSPropertyInfo;
</code>

===== Event-Informationen =====

==== TWvdSEventInfo ====

<code pascal>
type
  TWvdSEventInfo = record
    Name: string;           // Event-Name (z.B. 'Click')
    Description: string;    // Dokumentation
    HandlerSignature: string; // z.B. 'procedure(Sender: TObject)'
  end;
</code>

===== IntelliSense-Provider =====

==== GetCompletions ====

<code pascal>
function GetCompletions(AContext: TWvdSCompletionContext): TWvdSCompletionItemArray;
</code>

Gibt Vervollständigungsvorschläge für eine Position zurück.

<code pascal>
type
  TWvdSCompletionContext = record
    DocumentUri: string;
    Position: TPosition;
    TriggerCharacter: Char;
    CurrentElement: string;
    CurrentAttribute: string;
  end;

  TWvdSCompletionItem = record
    Label: string;
    Kind: TWvdSCompletionKind;
    Detail: string;
    Documentation: string;
    InsertText: string;
  end;
</code>

==== GetHoverInfo ====

<code pascal>
function GetHoverInfo(
  const ADocumentUri: string;
  APosition: TPosition
): TWvdSHoverInfo;
</code>

Gibt Hover-Dokumentation für eine Position zurück.

<code pascal>
type
  TWvdSHoverInfo = record
    Contents: string;       // Markdown-Inhalt
    Range: TRange;          // Bereich im Dokument
  end;
</code>

===== Cache-Verwaltung =====

==== RefreshRegistry ====

<code pascal>
procedure RefreshRegistry;
</code>

Lädt die Registry neu und aktualisiert den Cache.

==== ClearCache ====

<code pascal>
procedure ClearCache;
</code>

Löscht den Komponenten-Cache.

==== GetCachePath ====

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

Gibt den Pfad zum Cache-Verzeichnis zurück.

===== Annotations =====

Komponenten können via Annotations registriert werden:

<code pascal>
type
  ComponentInfoAttribute = class(TCustomAttribute)
    FName: string;
    FDescription: string;
    FCategory: string;
  public
    constructor Create(const AName, ADescription, ACategory: string);
  end;

  PropertyInfoAttribute = class(TCustomAttribute)
    FDescription: string;
    FDefaultValue: string;
  public
    constructor Create(const ADescription: string; const ADefault: string = '');
  end;
</code>

**Verwendung:**

<code pascal>
type
  {$M+}
  [ComponentInfo('MyButton', 'Button with icon', 'Input')]
  TMyButton = class(TWvdSButton)
  published
    [PropertyInfo('Path to icon image', '')]
    property IconPath: string read FIconPath write SetIconPath;

    [PropertyInfo('Button text', 'Click')]
    property Content: string read FContent write SetContent;
  end;
</code>

===== Siehe auch =====

  * [[.:core-api|Core API]]
  * [[.:vscode-wrapper|VSCode Wrapper]]
  * [[..:p:meta|UI Meta Extension]]