@sigma-file-manager/api 1.7.0 → 1.8.1

package/index.d.ts

@@ -128,6 +128,12 @@ export interface ExtensionKeybinding {
   when?: ExtensionKeybindingWhen;
 }
 
+export interface ExtensionIconThemeContribution {
+  id: string;
+  label: string;
+  path: string;
+}
+
 export interface ExtensionContributions {
   commands?: ExtensionCommand[];
   contextMenu?: ExtensionContextMenuItem[];
@@ -136,6 +142,7 @@ export interface ExtensionContributions {
   themes?: ExtensionThemeContribution[];
   configuration?: ExtensionConfiguration;
   keybindings?: ExtensionKeybinding[];
+  iconThemes?: ExtensionIconThemeContribution[];
 }
 
 export interface ExtensionEngines {
@@ -172,7 +179,7 @@ export interface ExtensionManifestMediaItem {
   type: ExtensionManifestMediaType;
 }
 
-export interface ExtensionManifest {
+export interface ExtensionManifestBase {
   id: string;
   name: string;
   previousName?: string;
@@ -185,16 +192,63 @@ export interface ExtensionManifest {
   media?: ExtensionManifestMediaItem[];
   categories?: string[];
   tags?: string[];
-  extensionType: ExtensionType;
-  main?: string;
   permissions: ExtensionPermission[];
   activationEvents?: ExtensionActivationEvent[];
-  contributes?: ExtensionContributions;
   platforms?: PlatformOS[];
   binaries?: ManifestBinaryDefinition[];
   engines: ExtensionEngines;
 }
 
+type DeclarativeOnlyExtensionContributionGuards = {
+  commands?: never;
+  contextMenu?: never;
+  sidebar?: never;
+  toolbar?: never;
+  configuration?: never;
+  keybindings?: never;
+};
+
+export type ThemeOnlyExtensionContributions = DeclarativeOnlyExtensionContributionGuards & (
+  | {
+    themes: ExtensionThemeContribution[];
+    iconThemes?: ExtensionIconThemeContribution[];
+  }
+  | {
+    themes?: ExtensionThemeContribution[];
+    iconThemes: ExtensionIconThemeContribution[];
+  }
+);
+
+export interface ApiExtensionManifest extends ExtensionManifestBase {
+  extensionType: 'api';
+  main: string;
+  contributes?: ExtensionContributions;
+}
+
+export interface ThemeOnlyApiExtensionManifest extends ExtensionManifestBase {
+  extensionType: 'api';
+  main?: never;
+  contributes: ThemeOnlyExtensionContributions;
+}
+
+export interface IframeExtensionManifest extends ExtensionManifestBase {
+  extensionType: 'iframe';
+  main: string;
+  contributes?: ExtensionContributions;
+}
+
+export interface WebviewExtensionManifest extends ExtensionManifestBase {
+  extensionType: 'webview';
+  main: string;
+  contributes?: ExtensionContributions;
+}
+
+export type ExtensionManifest
+  = | ApiExtensionManifest
+    | ThemeOnlyApiExtensionManifest
+    | IframeExtensionManifest
+    | WebviewExtensionManifest;
+
 export interface Disposable {
   dispose(): void;
 }

package/manifest.schema.json

@@ -61,14 +61,27 @@
             ],
             "properties": {
               "contributes": {
-                "required": [
-                  "themes"
+                "anyOf": [
+                  {
+                    "required": [
+                      "themes"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "iconThemes"
+                    ]
+                  }
                 ],
                 "additionalProperties": false,
                 "properties": {
                   "themes": {
                     "type": "array",
                     "minItems": 1
+                  },
+                  "iconThemes": {
+                    "type": "array",
+                    "minItems": 1
                   }
                 }
               }
@@ -562,6 +575,37 @@
               }
             }
           }
+        },
+        "iconThemes": {
+          "type": "array",
+          "description": "Navigator icon themes contributed by the extension",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "label",
+              "path"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S"
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S"
+              },
+              "path": {
+                "type": "string",
+                "description": "Relative path to the icon theme JSON file",
+                "minLength": 1,
+                "pattern": "^(?!\\s*$)(?!\\s*(?:[A-Za-z]:|[\\\\/]))(?!\\s*\\.\\.(?:[\\\\/]|\\s*$))(?!.*[\\\\/]\\.\\.(?:[\\\\/]|\\s*$))(?=.*[^.\\\\/\\s]).*$"
+              }
+            }
+          }
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sigma-file-manager/api",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "Type definitions and manifest schema for Sigma File Manager extensions",
   "license": "GPL-3.0-or-later",
   "repository": {