@edenapp/types 0.4.1 → 0.5.1

package/AppManifest.d.ts

@@ -67,6 +67,13 @@ export interface WindowConfig {
 
   /** Controls which Eden runtime helpers are injected into the app */
   injections?: WindowInjectionOptions;
+
+  /**
+   * How interface scaling is handled for this app.
+   * - "auto": SDK applies interface scale automatically (default for regular apps)
+   * - "manual": SDK doesn't apply scaling, app handles it (default for overlays)
+   */
+  scaling?: "auto" | "manual";
 }
 
 /**
@@ -107,9 +114,9 @@ export interface SettingOption {
   /** Value stored when this option is selected */
   value: string;
   /** Display label for this option */
-  label: string;
+  label: string | Record<string, string>;
   /** Optional description for this option */
-  description?: string;
+  description?: string | Record<string, string>;
 }
 
 /**
@@ -119,9 +126,11 @@ export interface SettingDefinition {
   /** Unique key for this setting */
   key: string;
   /** Display label */
-  label: string;
+  label: string | Record<string, string>;
   /** Description shown as help text */
-  description?: string;
+  description?: string | Record<string, string>;
+  /** Grant key used for access control */
+  grant?: string;
   /** Input type */
   type: SettingType;
   /** Default value (as string, will be parsed based on type) */
@@ -145,13 +154,67 @@ export interface SettingsCategory {
   /** Category ID */
   id: string;
   /** Display name */
-  name: string;
+  name: string | Record<string, string>;
+  /** Category description (optional) */
+  description?: string | Record<string, string>;
   /** Category icon (optional) */
   icon?: string;
+  /** Optional custom view ID for system settings */
+  view?: string;
+  /** Grant key used for access control */
+  grant?: string;
+  /** Grant scope (default: "settings") */
+  grantScope?: "settings" | "global";
   /** Settings in this category */
   settings: SettingDefinition[];
 }
 
+/**
+ * App-specific grant definition
+ */
+export type AppGrantDefinition =
+  | AppGrantDefinitionApp
+  | AppGrantDefinitionPreset;
+
+export interface AppGrantDefinitionApp {
+  /** Grant scope (default) */
+  scope?: "app";
+  /** Grant ID (namespaced by app ID at runtime) */
+  id: string;
+  /** Human-readable label */
+  label: string | Record<string, string>;
+  /** Optional description */
+  description?: string | Record<string, string>;
+  /** Optional permissions unlocked by this grant */
+  permissions?: string[];
+}
+
+export interface AppGrantDefinitionPreset {
+  /** Grant scope */
+  scope: "preset";
+  /** Preset ID (resolved by Eden at runtime) */
+  preset: string;
+}
+
+/**
+ * Resolved grant definition with full metadata.
+ * Used after preset resolution - both app and preset grants normalize to this shape.
+ */
+export interface ResolvedGrant {
+  /** Grant scope - "app" for app-specific, "preset" for system-wide presets */
+  scope: "app" | "preset";
+  /** Grant ID - unique identifier for this grant */
+  id: string;
+  /** Human-readable label */
+  label: string | Record<string, string>;
+  /** Optional description */
+  description?: string | Record<string, string>;
+  /** Permissions unlocked by this grant */
+  permissions: string[];
+  /** Original preset ID (only present for preset grants) */
+  preset?: string;
+}
+
 /**
  * App Manifest Interface
  *
@@ -162,8 +225,11 @@ export interface AppManifest {
   /** Unique identifier for the app (e.g., "com.example.myapp") */
   id: string;
 
-  /** Human-readable name */
-  name: string;
+  /**
+   * Human-readable name.
+   * Can be a simple string or a map of locales to names (e.g. { "en": "Files", "pl": "Pliki" })
+   */
+  name: string | Record<string, string>;
 
   /** Version string (semver recommended) */
   version: string;
@@ -234,9 +300,6 @@ export interface AppManifest {
     cwd?: string;
   };
 
-  /** Internal flag indicating if this is a prebuilt system app */
-  isPrebuilt?: boolean;
-
   /**
    * Permissions requested by this app.
    * Supports glob patterns: "fs/*" for all fs permissions, "*" for all permissions.
@@ -274,6 +337,11 @@ export interface AppManifest {
    */
   settings?: SettingsCategory[];
 
+  /**
+   * App-specific user grants for feature-level access control.
+   */
+  grants?: AppGrantDefinition[];
+
   /**
    * Additional files or directories to include in the bundle.
    * Use this to include files that are normally excluded (e.g., node_modules with native bindings).
@@ -282,3 +350,23 @@ export interface AppManifest {
    */
   include?: string[];
 }
+
+/**
+ * Runtime App Manifest
+ *
+ * Extended manifest with computed runtime fields.
+ * This is what Eden uses internally after loading and processing an app.
+ */
+export interface RuntimeAppManifest extends AppManifest {
+  /** Whether this is a prebuilt system app */
+  isPrebuilt: boolean;
+
+  /** Whether this is a core app (always allowed to launch) */
+  isCore: boolean;
+
+  /** Whether this app is restricted to vendor users */
+  isRestricted: boolean;
+
+  /** Grants with presets resolved to full definitions */
+  resolvedGrants: ResolvedGrant[];
+}

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @edenapp/types
 
+## 0.5.1
+
+## 0.5.0
+
+### Minor Changes
+
+- major ui refinement
+
 ## 0.4.1
 
 ### Patch Changes

package/ContextMenu.d.ts

@@ -0,0 +1,186 @@
+export type ContextMenuCloseReason =
+  | "select"
+  | "dismiss"
+  | "replaced"
+  | "close";
+
+export interface ContextMenuPosition {
+  left?: number;
+  right?: number;
+  top?: number;
+  bottom?: number;
+}
+
+/**
+ * Available icon names for context menu items.
+ */
+export type ContextMenuIconName =
+  // Actions
+  | "plus"
+  | "minus"
+  | "x"
+  | "check"
+  | "check-circle"
+  | "x-circle"
+  | "refresh-cw"
+  | "refresh-ccw"
+  | "rotate-cw"
+  | "rotate-ccw"
+  // Edit
+  | "edit"
+  | "edit-2"
+  | "edit-3"
+  | "scissors"
+  | "copy"
+  | "clipboard"
+  // Files
+  | "file"
+  | "file-text"
+  | "file-plus"
+  | "file-minus"
+  | "folder"
+  | "folder-plus"
+  | "folder-minus"
+  | "save"
+  | "download"
+  | "upload"
+  // Trash
+  | "trash"
+  | "trash-2"
+  // Navigation
+  | "arrow-up"
+  | "arrow-down"
+  | "arrow-left"
+  | "arrow-right"
+  | "chevron-up"
+  | "chevron-down"
+  | "chevron-left"
+  | "chevron-right"
+  | "corner-up-left"
+  | "corner-up-right"
+  | "move"
+  | "maximize"
+  | "minimize"
+  | "maximize-2"
+  | "minimize-2"
+  // View
+  | "eye"
+  | "eye-off"
+  | "zoom-in"
+  | "zoom-out"
+  | "search"
+  | "filter"
+  | "list"
+  | "grid"
+  | "layout"
+  | "sidebar"
+  | "columns"
+  // Media
+  | "play"
+  | "pause"
+  | "stop-circle"
+  | "skip-back"
+  | "skip-forward"
+  | "volume"
+  | "volume-1"
+  | "volume-2"
+  | "volume-x"
+  | "image"
+  | "camera"
+  | "film"
+  | "music"
+  // Communication
+  | "mail"
+  | "message-square"
+  | "message-circle"
+  | "send"
+  | "share"
+  | "share-2"
+  | "phone"
+  // Users
+  | "user"
+  | "user-plus"
+  | "user-minus"
+  | "user-x"
+  | "user-check"
+  | "users"
+  // Settings
+  | "settings"
+  | "sliders"
+  | "tool"
+  | "wrench"
+  | "terminal"
+  | "code"
+  // Status
+  | "info"
+  | "alert-circle"
+  | "alert-triangle"
+  | "help-circle"
+  | "bell"
+  | "bell-off"
+  // Misc
+  | "star"
+  | "heart"
+  | "bookmark"
+  | "flag"
+  | "tag"
+  | "clock"
+  | "calendar"
+  | "lock"
+  | "unlock"
+  | "key"
+  | "shield"
+  | "link"
+  | "link-2"
+  | "external-link"
+  | "log-in"
+  | "log-out"
+  | "power"
+  | "more-horizontal"
+  | "more-vertical"
+  | "menu"
+  | "home"
+  | "globe"
+  | "package"
+  | "printer"
+  | "archive"
+  | "box"
+  | "hash"
+  | "at-sign"
+  | "percent"
+  | "type"
+  | "bold"
+  | "italic"
+  | "underline"
+  | "align-left"
+  | "align-center"
+  | "align-right";
+
+export type ContextMenuItem =
+  | {
+      type: "item";
+      id: string;
+      label: string;
+      icon?: ContextMenuIconName;
+      shortcut?: string;
+      disabled?: boolean;
+      danger?: boolean;
+    }
+  | { type: "separator" }
+  | { type: "title"; label: string };
+
+export interface ContextMenuOpenArgs {
+  title?: string;
+  position: ContextMenuPosition;
+  items: ContextMenuItem[];
+}
+
+export interface ContextMenuOpenEvent extends ContextMenuOpenArgs {
+  requestId: string;
+}
+
+export interface ContextMenuResult {
+  requestId: string;
+  itemId?: string;
+  reason: ContextMenuCloseReason;
+}

package/EdenConfig.d.ts

@@ -28,12 +28,20 @@ export interface EdenConfig {
   window?: {
     width?: number;
     height?: number;
+    minWidth?: number;
+    minHeight?: number;
     title?: string;
     backgroundColor?: string;
   };
   tiling?: TilingConfig;
   development?: boolean;
 
-  /** List of app IDs to start automatically when Eden launches */
-  autostart?: string[];
+  /** App ID used for login UI when no user is active */
+  loginAppId?: string;
+
+  /** Apps allowed to launch regardless of user grants */
+  coreApps?: string[];
+
+  /** Apps blocked from launch for non-vendor users */
+  restrictedApps?: string[];
 }

package/EdenSeedConfig.d.ts

@@ -0,0 +1,24 @@
+import type { EdenUserConfig } from "./User";
+
+export interface EdenSeedSettings {
+  /** Map of appId to settings key/value pairs */
+  [appId: string]: Record<string, string>;
+}
+
+/**
+ * Seed data for one-time initialization
+ *
+ * Contains data that is seeded into the database on first run.
+ * This is separate from runtime config because the data becomes
+ * mutable after seeding.
+ */
+export interface EdenSeedConfig {
+  /** Users to seed on first run */
+  users?: EdenUserConfig[];
+
+  /** Default username to seed */
+  defaultUsername?: string;
+
+  /** Settings to seed (namespaced by appId) */
+  settings?: EdenSeedSettings;
+}

package/User.d.ts

@@ -0,0 +1,20 @@
+export type UserRole = "standard" | "vendor";
+
+export interface UserProfile {
+  username: string;
+  name: string;
+  role: UserRole;
+  grants: string[];
+  createdAt: number;
+  updatedAt: number;
+}
+
+export interface EdenUserConfig {
+  username: string;
+  name: string;
+  role?: UserRole;
+  password?: string;
+  passwordHash?: string;
+  passwordSalt?: string;
+  grants?: string[];
+}

package/commands.generated.d.ts

@@ -1,8 +1,9 @@
 /**
  * AUTO-GENERATED FILE - DO NOT EDIT
- * 
- * This file is automatically generated by scripts/generate-commands.ts
- * Run 'npm run codegen' to regenerate.
+ *
+ * This file is automatically generated by scripts/codegen
+ * Generated by scripts/codegen
+ * Run 'pnpm run codegen' to regenerate.
  */
 
 /**
@@ -72,6 +73,51 @@ export interface AppbusCommands {
   };
 }
 
+/**
+ * AppearanceCommands - Commands for the "appearance" namespace
+ */
+export interface AppearanceCommands {
+  "appearance/set-wallpaper": {
+    args: {
+    wallpaper: import("./index").WallpaperConfig };
+    response: void;
+  };
+  "appearance/get-wallpaper": {
+    args: Record<string, never>;
+    response: { wallpaper: import("./index").WallpaperPreset };
+  };
+  "appearance/get-presets": {
+    args: Record<string, never>;
+    response: {
+    solid: import("./index").WallpaperPreset[];
+    gradients: import("./index").WallpaperPreset[];
+  };
+  };
+}
+
+/**
+ * ContextMenuCommands - Commands for the "context-menu" namespace
+ */
+export interface ContextMenuCommands {
+  "context-menu/register-display": {
+    args: { };
+    response: { success: boolean };
+  };
+  "context-menu/open": {
+    args: import("./index").ContextMenuOpenArgs & { };
+    response: { requestId: string };
+  };
+  "context-menu/resolve": {
+    args: import("./index").ContextMenuResult & { };
+    response: { success: boolean };
+  };
+  "context-menu/close": {
+    args: {
+    requestId?: string };
+    response: { success: boolean };
+  };
+}
+
 /**
  * DbCommands - Commands for the "db" namespace
  */
@@ -193,21 +239,26 @@ export interface FileCommands {
    * Open a file with a specific app
    */
   "file/open-with": {
-    args: { path: string; appId: string };
+    args: {
+    path: string;
+    appId: string };
     response: import("./index").FileOpenResult;
   };
   /**
    * Get the default handler app for a file extension
    */
   "file/get-handler": {
-    args: { extension: string };
+    args: {
+    extension: string };
     response: { appId: string | undefined };
   };
   /**
    * Set user preference for a file extension's default handler
    */
   "file/set-default-handler": {
-    args: { extension: string; appId: string };
+    args: {
+    extension: string;
+    appId: string };
     response: void;
   };
   /**
@@ -221,7 +272,8 @@ export interface FileCommands {
    * Get all apps that can handle a specific file extension
    */
   "file/get-supported-handlers": {
-    args: { extension: string };
+    args: {
+    extension: string };
     response: import("./index").FileHandlerInfo[];
   };
   /**
@@ -229,7 +281,10 @@ export interface FileCommands {
    */
   "file/get-associations": {
     args: Record<string, never>;
-    response: Record<string, { default: string | undefined; userOverride: string | undefined }>;
+    response: Record<
+      string,
+      { default: string | undefined; userOverride: string | undefined }
+    >;
   };
 }
 
@@ -304,22 +359,34 @@ export interface FsCommands {
   };
 }
 
+/**
+ * I18nCommands - Commands for the "i18n" namespace
+ */
+export interface I18nCommands {
+  "i18n/get-locale": {
+    args: Record<string, never>;
+    response: { locale: string };
+  };
+  "i18n/get-common": {
+    args: { locale: string };
+    response: {
+    translations: Record<string, any>;
+  };
+  };
+}
+
 /**
  * EventCommands - Commands for the "event" namespace
  */
 export interface EventCommands {
   "event/subscribe": {
     args: {
-    eventName: string;
-    _callerWebContentsId?: number;
-    _callerAppId?: string };
+    eventName: string };
     response: void;
   };
   "event/unsubscribe": {
     args: {
-    eventName: string;
-    _callerWebContentsId?: number;
-    _callerAppId?: string };
+    eventName: string };
     response: void;
   };
   "event/exists": {
@@ -353,8 +420,9 @@ export interface PackageCommands {
    * Install an application from a local path.
    */
   "package/install": {
-    args: { sourcePath: string };
-    response: import("./index").AppManifest;
+    args: {
+    sourcePath: string };
+    response: import("./index").RuntimeAppManifest;
   };
   /**
    * Uninstall an application by its ID.
@@ -365,11 +433,14 @@ export interface PackageCommands {
   };
   /**
    * List all installed applications.
-   * @param showHidden - If true, includes overlay apps (hidden by default)
+   * @param showHidden - If true, includes overlay apps and daemons (hidden by default)
+   * @param showRestricted - If true, includes apps the current user cannot launch (hidden by default)
    */
   "package/list": {
-    args: { showHidden?: boolean };
-    response: import("./index").AppManifest[];
+    args: {
+    showHidden?: boolean;
+    showRestricted?: boolean };
+    response: import("./index").RuntimeAppManifest[];
   };
   /**
    * Toggle hot reload for an app
@@ -403,6 +474,14 @@ export interface PackageCommands {
     path: string };
     response: { success: boolean; manifest?: import("./index").AppManifest; error?: string };
   };
+  /**
+   * Get the installed size of an app in bytes
+   */
+  "package/get-size": {
+    args: {
+    appId: string };
+    response: { size: number | undefined };
+  };
 }
 
 /**
@@ -500,18 +579,22 @@ export interface SettingsCommands {
   };
   /**
    * List all settings in any app's namespace (superuser only)
+   * @param showRestricted - If true, includes settings the current user cannot access (hidden by default)
    */
   "settings/list/su": {
     args: {
-    appId: string };
+    appId: string;
+    showRestricted?: boolean };
     response: { keys: string[] };
   };
   /**
    * Get all settings with values for any app (superuser only)
+   * @param showRestricted - If true, includes settings the current user cannot access (hidden by default)
    */
   "settings/get-all/su": {
     args: {
-    appId: string };
+    appId: string;
+    showRestricted?: boolean };
     response: { settings: Record<string, string> };
   };
   /**
@@ -526,13 +609,122 @@ export interface SettingsCommands {
   };
   /**
    * Get the Eden settings schema
+   * @param showRestricted - If true, includes settings the current user cannot access (hidden by default)
    */
   "settings/schema": {
-    args: Record<string, never>;
+    args: {
+    showRestricted?: boolean };
     response: { schema: import("./index").SettingsCategory[] };
   };
 }
 
+/**
+ * UserCommands - Commands for the "user" namespace
+ */
+export interface UserCommands {
+  /**
+   * List all users.
+   */
+  "user/list": {
+    args: Record<string, never>;
+    response: { users: import("./index").UserProfile[] };
+  };
+  /**
+   * Return the current logged-in user.
+   */
+  "user/get-current": {
+    args: Record<string, never>;
+    response: { user: import("./index").UserProfile | null };
+  };
+  /**
+   * Authenticate a user and establish a session.
+   */
+  "user/login": {
+    args: {
+    username: string;
+    password: string };
+    response: { success: boolean; user?: import("./index").UserProfile; error?: string };
+  };
+  /**
+   * End the current session.
+   */
+  "user/logout": {
+    args: Record<string, never>;
+    response: { success: boolean };
+  };
+  /**
+   * Create a new user.
+   */
+  "user/create": {
+    args: {
+    username?: string;
+    name: string;
+    role?: import("./index").UserRole;
+    password: string;
+    grants?: string[] };
+    response: { user: import("./index").UserProfile };
+  };
+  /**
+   * Update user profile details or grants.
+   */
+  "user/update": {
+    args: {
+    username: string;
+    name?: string;
+    role?: import("./index").UserRole;
+    grants?: string[] };
+    response: { user: import("./index").UserProfile };
+  };
+  /**
+   * Delete a user.
+   */
+  "user/delete": {
+    args: {
+    username: string };
+    response: { success: boolean };
+  };
+  /**
+   * Set a user's password.
+   */
+  "user/set-password": {
+    args: {
+    username: string;
+    password: string };
+    response: { success: boolean };
+  };
+  /**
+   * Change the current user's password.
+   */
+  "user/change-password": {
+    args: {
+    currentPassword: string;
+    newPassword: string };
+    response: { success: boolean; error?: string };
+  };
+  /**
+   * Check whether the current user has a specific grant.
+   */
+  "user/has-grant": {
+    args: { grant: string };
+    response: { allowed: boolean };
+  };
+  /**
+   * Return the configured default username.
+   */
+  "user/get-default": {
+    args: Record<string, never>;
+    response: { username: string | null };
+  };
+  /**
+   * Update the configured default username.
+   */
+  "user/set-default": {
+    args: {
+    username: string | null };
+    response: { success: boolean };
+  };
+}
+
 /**
  * ViewCommands - Commands for the "view" namespace
  */
@@ -629,9 +821,25 @@ export interface ViewCommands {
     args: Record<string, never>;
     response: import("./index").WindowSize;
   };
+  /**
+   * Set the interface scale (zoom factor) for all views.
+   * @param scale - Scale factor as a string (e.g., "1.0" for 100%, "1.5" for 150%)
+   */
+  "view/set-interface-scale": {
+    args: {
+    scale: string };
+    response: { success: boolean };
+  };
+  /**
+   * Get the current interface scale.
+   */
+  "view/get-interface-scale": {
+    args: Record<string, never>;
+    response: { scale: number };
+  };
 }
 
 /**
  * Global command map - merge all command namespaces
  */
-export interface CommandMap extends SystemCommands, AppbusCommands, DbCommands, FileCommands, FsCommands, EventCommands, NotificationCommands, PackageCommands, ProcessCommands, SettingsCommands, ViewCommands {}
+export interface CommandMap extends SystemCommands, AppbusCommands, AppearanceCommands, ContextMenuCommands, DbCommands, FileCommands, FsCommands, I18nCommands, EventCommands, NotificationCommands, PackageCommands, ProcessCommands, SettingsCommands, UserCommands, ViewCommands {}

package/events.generated.d.ts

@@ -1,10 +1,26 @@
 /**
  * AUTO-GENERATED FILE - DO NOT EDIT
- * 
- * This file is automatically generated by scripts/generate-commands.ts
+ *
+ * This file is automatically generated by scripts/codegen
+ * Generated by scripts/codegen
  * Run 'pnpm run codegen' to regenerate.
  */
 
+/**
+ * AppearanceEvents - Events for the "appearance" namespace
+ */
+export interface AppearanceEvents {
+  "appearance/wallpaper-changed": import("./index").WallpaperPreset;
+}
+
+/**
+ * ContextMenuEvents - Events for the "context-menu" namespace
+ */
+export interface ContextMenuEvents {
+  "context-menu/opened": { menu: import("./index").ContextMenuOpenEvent };
+  "context-menu/closed": import("./index").ContextMenuResult;
+}
+
 /**
  * FileEvents - Events for the "file" namespace
  */
@@ -12,6 +28,13 @@ export interface FileEvents {
   "file/opened": { path: string; isDirectory: boolean; appId: string };
 }
 
+/**
+ * I18nEvents - Events for the "i18n" namespace
+ */
+export interface I18nEvents {
+  "i18n/locale-changed": { locale: string };
+}
+
 /**
  * NotificationEvents - Events for the "notification" namespace
  */
@@ -24,7 +47,7 @@ export interface NotificationEvents {
  * PackageEvents - Events for the "package" namespace
  */
 export interface PackageEvents {
-  "package/installed": { manifest: import("./index").AppManifest };
+  "package/installed": { manifest: import("./index").RuntimeAppManifest };
   "package/uninstalled": { appId: string };
 }
 
@@ -45,6 +68,17 @@ export interface SettingsEvents {
   "settings/changed": { appId: string; key: string; value: string };
 }
 
+/**
+ * UserEvents - Events for the "user" namespace
+ */
+export interface UserEvents {
+  "user/changed": {
+    currentUser: import("./index").UserProfile | null;
+    previousUsername: string | null;
+    reason: "login" | "logout" | "system";
+  };
+}
+
 /**
  * ViewEvents - Events for the "view" namespace
  */
@@ -67,4 +101,4 @@ export interface ViewEvents {
 /**
  * Global event map - merge all event namespaces
  */
-export interface AppEvents extends FileEvents, NotificationEvents, PackageEvents, ProcessEvents, SettingsEvents, ViewEvents {}
+export interface AppEvents extends AppearanceEvents, ContextMenuEvents, FileEvents, I18nEvents, NotificationEvents, PackageEvents, ProcessEvents, SettingsEvents, UserEvents, ViewEvents {}

package/global.d.ts

@@ -5,10 +5,12 @@ import type { EdenAPI, AppBusAPI, AppBusConnection } from "./ipc";
 export interface EdenFrame {
   // Public API
   setTitle: (title: string) => void;
+  resetTitle: () => void;
 
   // Internal state (used by frame system)
   _internal: {
     appId: string;
+    appName: string | Record<string, string>;
     injected: boolean;
     config: {
       mode?: "tiled" | "floating" | "both";

package/index.d.ts

@@ -1,6 +1,8 @@
 import { AppManifest } from "./AppManifest";
 
 export * from "./EdenConfig";
+export * from "./EdenSeedConfig";
+export * from "./User";
 
 export * from "./AppManifest";
 
@@ -93,6 +95,7 @@ export interface SystemInfo {
   nodeVersion: string;
   electronVersion: string;
   runningApps: string[];
+  release: boolean;
 }
 
 export interface WindowSize {
@@ -162,3 +165,16 @@ export interface Notification {
   /** Notification type for styling (default: info) */
   type?: NotificationType;
 }
+
+export * from "./ContextMenu";
+
+export interface WallpaperPreset {
+  id: string;
+  name: string;
+  type: "color" | "gradient" | "custom";
+  value: string;
+}
+
+export type WallpaperConfig =
+  | { type: "preset"; id: string }
+  | { type: "custom"; value: string };

package/ipc/appbus.d.ts

@@ -117,31 +117,31 @@ export interface AppBusConnection<
   /** Listen for messages from the other side */
   on<K extends keyof TReceive>(
     method: K,
-    callback: (args: TReceive[K]) => void
+    callback: (args: TReceive[K]) => void,
   ): void;
   /** Listen for messages only once, then auto-remove */
   once<K extends keyof TReceive>(
     method: K,
-    callback: (args: TReceive[K]) => void
+    callback: (args: TReceive[K]) => void,
   ): void;
   /** Remove a listener */
   off<K extends keyof TReceive>(
     method: K,
-    callback: (args: TReceive[K]) => void
+    callback: (args: TReceive[K]) => void,
   ): void;
 
   /** Send a request and wait for response (other side handles) */
   request<K extends keyof TRequest>(
     method: K,
-    args?: TRequest[K]["args"]
+    args?: TRequest[K]["args"],
   ): Promise<TRequest[K]["result"]>;
 
   /** Register a handler for requests from the other side */
   handle<K extends keyof THandle>(
     method: K,
     handler: (
-      args: THandle[K]["args"]
-    ) => THandle[K]["result"] | Promise<THandle[K]["result"]>
+      args: THandle[K]["args"],
+    ) => THandle[K]["result"] | Promise<THandle[K]["result"]>,
   ): void;
   /** Remove a handler */
   removeHandler<K extends keyof THandle>(method: K): void;
@@ -166,7 +166,7 @@ export interface ClientInfo {
  */
 export type ServiceConnectCallback = (
   connection: AppBusConnection,
-  clientInfo: ClientInfo
+  clientInfo: ClientInfo,
 ) => void;
 
 /**
@@ -200,7 +200,7 @@ export interface AppBusAPI {
   exposeService(
     serviceName: string,
     onConnect: ServiceConnectCallback,
-    options?: ServiceOptions
+    options?: ServiceOptions,
   ): Promise<{ success: boolean; error?: string }>;
 
   /**
@@ -216,7 +216,7 @@ export interface AppBusAPI {
    */
   connect(
     targetAppId: string,
-    serviceName: string
+    serviceName: string,
   ): Promise<AppBusConnection | { error: string }>;
 
   /**

package/ipc/edenapi.d.ts

@@ -28,7 +28,7 @@ export interface EdenAPI {
    */
   shellCommand<T extends CommandName>(
     command: T,
-    args: CommandArgs<T>
+    args: CommandArgs<T>,
   ): Promise<CommandResult<T>>;
 
   /**
@@ -38,7 +38,7 @@ export interface EdenAPI {
    */
   subscribe<T extends EventName>(
     event: T,
-    callback: (data: EventData<T>) => void
+    callback: (data: EventData<T>) => void,
   ): Promise<void>;
 
   /**
@@ -46,7 +46,7 @@ export interface EdenAPI {
    */
   unsubscribe<T extends EventName>(
     event: T,
-    callback: (data: EventData<T>) => void
+    callback: (data: EventData<T>) => void,
   ): void;
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edenapp/types",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "TypeScript type definitions for the Eden platform",
   "types": "index.d.ts",
   "author": "Dariusz Majnert",