Plugin manifesti

Manifest strict JSON belgesidir; tanınmayan alanlar reddedilir.

{
  "schemaVersion": 1,
  "pluginId": "c6d3ccf8-c96c-46b6-a254-8fce86337c37",
  "sdkVersion": "0.1.0",
  "name": "Yerel Sayaç Örneği",
  "version": "1.0.0",
  "runtime": { "kind": "trusted-node", "entry": "runtime.mjs" },
  "hostCompatibility": { "minimumVersion": "0.2.0" },
  "permissions": [{ "name": "key.display" }],
  "settingsSchema": [],
  "actions": [{ "id": "counter", "name": "Sayaç", "controllers": ["Keypad"], "settingsSchema": [] }]
}

Kimlik

pluginId immutable kimliktir.
Runtime action kimliği pluginId + local action id birleşimidir.
Action ID’leri aynı manifest içinde benzersizdir.
Runtime kimliği request payloadıyla değiştiremez.

Runtime

`runtime.kind`	Entry
`trusted-node`	`.js`, `.mjs` veya `.cjs`
`sandbox-js`	Browser-compatible `.js` veya `.mjs`
`wasm`	`.wasm`; sonraki language-neutral hedef

Setting keyleri lower camelCase kullanır. secret ve oauth alanları default değer taşıyamaz; raw credential normal setting veya manifest içine yazılmaz. Manifest yalnız gerekli permission descriptorlarını bildirmelidir. Runtime grant seti declared ∩ user-granted olarak hesaplanır.

Platformlar ve sistem beyanları

platforms, eklentinin çalıştığı masaüstü platformlarını listeler: windows, macos, linux. Alan yoksa platform kısıtı yoktur. evox-plugin pack bu listeyi paketin kök manifestine de yazar. trusted-node (T1) eklentisi çalıştırdığı programları ve dokunduğu sistem yollarını beyan eder:

{
  "platforms": ["linux"],
  "declaredCommands": [
    { "command": "hyprctl", "purpose": "Çalışma alanı değiştirme" }
  ],
  "declaredPaths": [
    { "path": "/proc/stat", "access": "read", "purpose": "CPU grafiği" },
    { "path": "/proc/net/", "access": "read", "purpose": "Ağ grafiği" }
  ]
}

command, PATH’te aranan yalın program adıdır. Yol, argüman ve kabuk sözdizimi kabul edilmez.
path mutlak (/…), ev dizinine göre (~/…) ya da Windows ortam değişkenine göre (%APPDATA%\…) yazılır; .. segmenti kabul edilmez. * tek bir segment içinde eşleşir; / ile biten yol altındaki her şeyi kapsar.
access değeri read ya da write olur.
sandbox-js (T2) eklentisi komut ya da yol beyan edemez; T2’de bu erişimler zaten yoktur.

Beyanlar çalışma anında zorlanmaz. T1 sandbox değildir ve beyan kodu sınırlamaz. evox-plugin publish-check beyanları bundle’la karşılaştırır (bkz. Developer CLI). T1 eklentiler için Market yüklemesi henüz kapalıdır (TRUSTED_PLUGIN_UPLOAD_NOT_READY).

İkon (`glyph`)

Plugin ve her action kendi ikonunu seçebilir. Beyan edilmezse ikisi de varsayılan kod ikonunu gösterir; action glyph taşımıyorsa plugin glyph’ine düşer.

{
  "glyph": "CommandLineIcon",
  "actions": [
    { "id": "prompt", "name": "Prompt gönder", "glyph": "AiChat01Icon" },
    { "id": "abort", "name": "Durdur", "glyph": "StopCircleIcon" }
  ]
}

Değer bir Hugeicons adıdır ve sabit bir listeden seçilir. Serbest ad kabul edilmez: host glyph’leri hem masaüstü rasterizer’ında hem arayüzde tek tek statik import eder, ikon setinin tamamını paketlemek renderer bütçesini aşardı. Listede olmayan bir ad manifesti reddettirir.

Geçerli adların tam listesi PLUGIN_GLYPH_NAMES içindedir (@evox/plugin-protocol). Listeye ad eklemek host tarafında bir değişikliktir; ihtiyacın olan glyph yoksa talep aç.

Koşullu ayar görünürlüğü (`visibleWhen`)

Bir setting yalnız başka bir setting belirli bir değerdeyken gösterilebilir.

{
  "settingsSchema": [
    {
      "key": "preset",
      "type": "select",
      "label": "Preset",
      "default": "tests",
      "options": [
        { "value": "tests", "label": "Testleri çalıştır" },
        { "value": "custom", "label": "Özel prompt" }
      ]
    },
    {
      "key": "prompt",
      "type": "text",
      "label": "Özel prompt",
      "visibleWhen": { "key": "preset", "in": ["custom"] }
    }
  ]
}

key aynı settingsSchema içindeki başka bir setting’i göstermelidir. Olmayan bir key’e veya alanın kendisine referans manifesti reddettirir — ikisi de alanı sessizce sonsuza dek gizlerdi.
Karşılaştırma büyük/küçük harfe duyarsızdır.
Referans verilen setting’in değeri boşsa o setting’in default’una bakılır; yukarıdaki örnekte hiç dokunulmamış bir tuşta preset varsayılan tests olduğu için prompt alanı gizli gelir.
Gizli alanın kaydedilmiş değeri silinmez; kullanıcı koşulu sağlayan seçeneğe dönünce eski değeri bulur.

Başlangıç

Temel kavramlar

Örnekler ve dağıtım

Kimlik

Runtime

Platformlar ve sistem beyanları

İkon (`glyph`)

Koşullu ayar görünürlüğü (`visibleWhen`)

​Kimlik

​Runtime

​Platformlar ve sistem beyanları

​İkon (glyph)

​Koşullu ayar görünürlüğü (visibleWhen)

Kimlik

Runtime

Platformlar ve sistem beyanları

İkon (`glyph`)

Koşullu ayar görünürlüğü (`visibleWhen`)