@sigma-file-manager/api 1.7.1 → 1.9.0

package/index.d.ts

@@ -67,6 +67,39 @@ export interface ExtensionSidebarItem {
   shortcutCommandId?: string;
 }
 
+export type ExtensionClipboardContentType = 'text' | 'image' | 'files' | 'empty';
+
+export interface ExtensionClipboardImageMeta {
+  width: number;
+  height: number;
+  sizeBytes: number;
+}
+
+export interface ExtensionClipboardImagePayload extends ExtensionClipboardImageMeta {
+  pngBytes: Uint8Array;
+  contentFingerprint: string;
+}
+
+export interface ExtensionClipboardSnapshot {
+  type: ExtensionClipboardContentType;
+  changeToken: string;
+  fingerprint: string;
+  preview: string;
+  text?: string;
+  image?: ExtensionClipboardImageMeta;
+  files?: {
+    paths: string[];
+    operation: 'copy' | 'move';
+  };
+}
+
+export interface ExtensionClipboardSourceContext {
+  windowTitle?: string;
+  processName?: string;
+  processPath?: string;
+  processIconUrl?: string;
+}
+
 export interface ExtensionToolbarDropdownItem {
   id: string;
   title: string;
@@ -128,6 +161,12 @@ export interface ExtensionKeybinding {
   when?: ExtensionKeybindingWhen;
 }
 
+export interface ExtensionIconThemeContribution {
+  id: string;
+  label: string;
+  path: string;
+}
+
 export interface ExtensionContributions {
   commands?: ExtensionCommand[];
   contextMenu?: ExtensionContextMenuItem[];
@@ -136,10 +175,12 @@ export interface ExtensionContributions {
   themes?: ExtensionThemeContribution[];
   configuration?: ExtensionConfiguration;
   keybindings?: ExtensionKeybinding[];
+  iconThemes?: ExtensionIconThemeContribution[];
 }
 
 export interface ExtensionEngines {
   sigmaFileManager: string;
+  extensionApi?: string;
 }
 
 export type PlatformOS = 'windows' | 'macos' | 'linux';
@@ -192,15 +233,25 @@ export interface ExtensionManifestBase {
   engines: ExtensionEngines;
 }
 
-export interface ThemeOnlyExtensionContributions {
-  themes: ExtensionThemeContribution[];
+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';
@@ -298,6 +349,10 @@ export interface ExtensionDirEntry {
   isDirectory: boolean;
   size?: number;
   modifiedAt?: number;
+  linkType?: 'symlink' | 'shortcut' | 'junction' | 'hardlink' | null;
+  linkTarget?: string | null;
+  linkStatus?: 'valid' | 'broken' | 'unknown' | 'unsupported' | null;
+  hardLinkCount?: number | null;
 }
 
 export interface ExtensionScopedDirectory {
@@ -399,23 +454,86 @@ export interface ModalButton {
   label: string;
   variant?: 'primary' | 'secondary' | 'danger';
   shortcut?: KeyboardShortcut;
+  disabled?: boolean;
+}
+
+export type ListDetailItemIcon = 'text' | 'image' | 'files';
+
+export interface ListDetailItem {
+  id: string;
+  title: string;
+  subtitle?: string;
+  thumbnailUrl?: string;
+  icon?: ListDetailItemIcon;
+  badge?: string;
+  pinned?: boolean;
 }
 
+export interface ListDetailField {
+  label: string;
+  value: string;
+  iconUrl?: string;
+  systemIconPath?: string;
+}
+
+export interface ListDetailPreview {
+  type: 'text' | 'image' | 'files' | 'empty';
+  text?: string;
+  imageUrl?: string;
+  imageStoragePath?: string;
+  filePaths?: string[];
+}
+
+export interface ListDetailGroupLabels {
+  pinned?: string;
+  recent?: string;
+}
+
+export interface ListDetailState {
+  items: ListDetailItem[];
+  selectedItemId: string | null;
+  searchQuery: string;
+  filterValue: string;
+  filterOptions: UISelectOption[];
+  searchPlaceholder?: string;
+  detail: ListDetailPreview | null;
+  detailFields: ListDetailField[];
+  listGroupLabels?: ListDetailGroupLabels;
+  emptyListTitle?: string;
+  emptyListDescription?: string;
+  emptyDetailTitle?: string;
+  emptyDetailDescription?: string;
+}
+
+export type ModalLayout = 'form' | 'listDetail';
+
 export interface ModalOptions {
   title: string;
+  commandTitle?: string;
   width?: number;
-  content: UIElement[];
+  layout?: ModalLayout;
+  content?: UIElement[];
+  listDetail?: ListDetailState;
   buttons?: ModalButton[];
 }
 
+export type ListDetailSelectionChangeCallback = (itemId: string | null) => void | Promise<void>;
+export type ListDetailSearchChangeCallback = (searchQuery: string) => void | Promise<void>;
+export type ListDetailFilterChangeCallback = (filterValue: string) => void | Promise<void>;
+
 export interface ModalHandle {
   onSubmit(callback: (values: Record<string, unknown>, buttonId: string) => void | boolean | Promise<void | boolean>): void;
   onClose(callback: () => void): void;
   onValueChange(callback: (elementId: string, value: unknown, allValues: Record<string, unknown>) => void): void;
+  onSelectionChange(callback: ListDetailSelectionChangeCallback): void;
+  onSearchChange(callback: ListDetailSearchChangeCallback): void;
+  onFilterChange(callback: ListDetailFilterChangeCallback): void;
   close(): void;
   updateElement(id: string, updates: Partial<UIElement>): void;
   setContent(content: UIElement[]): void;
-  setButtons(buttons: ModalButton[]): void;
+  setButtons(buttons: ModalButton[]): void | Promise<void>;
+  setListDetail(updates: Partial<ListDetailState>): void | Promise<void>;
+  getListDetail(): ListDetailState;
   getValues(): Record<string, unknown>;
 }
 
@@ -527,6 +645,30 @@ export interface SigmaExtensionAPI {
      * Throws if only unsupported types are provided.
      */
     clipboardWrite(items: Record<string, Uint8Array>[]): Promise<void>;
+    restoreClipboardImageFromStorage(relativePath: string): Promise<void>;
+    pathExists(path: string): Promise<boolean>;
+    /**
+     * Reads the current system clipboard content.
+     * Priority: files, image, plain text.
+     */
+    clipboardRead(): Promise<ExtensionClipboardSnapshot>;
+    /**
+     * Returns best-effort metadata about the current foreground window.
+     * Intended to be sampled when a new clipboard entry is captured.
+     */
+    getClipboardSource(): Promise<ExtensionClipboardSourceContext>;
+    /**
+     * Reads the current clipboard image bytes. Returns null when no image is available.
+     */
+    clipboardReadImage(): Promise<ExtensionClipboardImagePayload | null>;
+    /**
+     * Subscribes to system clipboard changes detected by the app.
+     */
+    onClipboardChange(callback: () => void | Promise<void>): Disposable;
+    /**
+     * Writes file paths to the system clipboard.
+     */
+    clipboardWriteFiles(paths: string[], operation?: 'copy' | 'move'): Promise<void>;
     withProgress<T>(
       options: ProgressOptions,
       task: (progress: Progress, token: CancellationToken) => Promise<T>

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]).*$"
+              }
+            }
+          }
         }
       }
     },
@@ -687,6 +731,10 @@
         "sigmaFileManager": {
           "type": "string",
           "description": "Required Sigma File Manager version range"
+        },
+        "extensionApi": {
+          "type": "string",
+          "description": "Required @sigma-file-manager/api version range"
         }
       }
     }

package/package.json

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