@voltius/plugin-types 0.35.1 → 0.37.0

package/index.d.ts

@@ -87,7 +87,7 @@ export interface AppTheme {
   terminal: TerminalTheme;
 }
 
-export type Locale = "en" | "fr" | "ru" | "zh";
+export type Locale = "en" | "fr" | "ru" | "zh" | "tr";
 
 export type PluginAuditAction =
   | "agent.grant_created"
@@ -320,12 +320,40 @@ export interface PluginTransfer {
   owner?: string;
 }
 
+export type SyncProviderStatus = "idle" | "syncing" | "success" | "error" | "offline";
+
+export type SyncProviderAvailability = "active" | "not_configured" | "disabled" | "locked" | "needs_upgrade";
+
+/** What a sync provider plugin publishes under `publishState("sync-state", …)`. */
+export interface SyncProviderState {
+  status: SyncProviderStatus;
+  lastSync: Date | string | number | null;
+  error: string | null;
+  blobSizeBytes: number | null;
+  configured: boolean;
+}
+
+/** What a sync provider plugin passes to `plugins.expose`. */
+export interface SyncProviderPublicApi {
+  syncNow(): Promise<void>;
+}
+
+export interface SyncProviderSummary {
+  id: string;
+  label: string;
+  availability: SyncProviderAvailability;
+  status: SyncProviderStatus;
+  lastSync: string | null;
+  error: string | null;
+}
+
 export interface PluginSyncState {
-  status: "idle" | "syncing" | "success" | "error" | "offline";
+  status: SyncProviderStatus;
   lastSync: string | null;
   error: string | null;
   cloudActive: boolean;
   blobSizeBytes: number | null;
+  providers: SyncProviderSummary[];
 }
 
 export interface PluginHostPing {
@@ -1268,7 +1296,7 @@ export interface PluginAPI {
     /** Publish a plain, serialisable state snapshot for host UI to read, keyed
      *  by `<pluginId>::<key>`. Host surfaces subscribe to this instead of
      *  importing the plugin's runtime module. Cleared on unload/disable. */
-    publishState(key: string, value: unknown): void;
+    publishState<K extends string>(key: K, value: K extends "sync-state" ? SyncProviderState : unknown): void;
   };
 
   // Plugin-scoped key-value storage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltius/plugin-types",
-  "version": "0.35.1",
+  "version": "0.37.0",
   "description": "TypeScript definitions for the Voltius plugin API",
   "types": "index.d.ts",
   "files": [

package/ui.d.ts

@@ -32,4 +32,15 @@ declare module "@voltius/ui" {
     onConfirm: () => void;
     onCancel: () => void;
   }>;
+  export type StatusTone = "connected" | "connecting" | "warning" | "error" | "idle" | "accent";
+  export const StatusDot: ComponentType<{
+    tone: StatusTone;
+    size?: "sm" | "md";
+    hollow?: boolean;
+    halo?: string;
+    corner?: boolean;
+    motion?: "pulse" | "ping" | "ping-fast";
+    label?: string;
+    className?: string;
+  }>;
 }