orgnote-api 0.2.2 → 0.3.0

package/api.ts

@@ -7,6 +7,7 @@ import {
   MultilineEmbeddedWidget,
   OrgLineClass,
   WidgetBuilder,
+  CommandPreview,
 } from './models';
 import type { NavigationFailure } from 'vue-router';
 import { WidgetType } from './models/widget-type';
@@ -68,10 +69,10 @@ export interface OrgNoteApi {
     remove(...commands: Command[]): void;
     get(name: string): Command;
     getAll(): Command[];
-    addCommandToSidebar(...commands: Command[]): void;
-    removeCommandFromSidebar(...commands: Command[]): void;
-    addCommandToEditorPanel(...commands: Command[]): void;
-    removeCommandFromEditorPanel(...commands: Command[]): void;
+    addCommandToSidebar(...commands: CommandPreview[]): void;
+    removeCommandFromSidebar(...commands: CommandPreview[]): void;
+    addCommandToEditorPanel(...commands: CommandPreview[]): void;
+    removeCommandFromEditorPanel(...commands: CommandPreview[]): void;
   };
   configuration: () => OrgNoteConfig;
 }

package/models/command.ts

@@ -8,26 +8,35 @@ export type CommandGroup =
   | 'completion'
   | string;
 
-export interface CommandHandlerParams {
+export interface CommandHandlerParams<T = any> {
   event?: KeyboardEvent;
-  data?: unknown;
+  data?: T;
   [key: string]: unknown;
 }
 
-export interface Command {
-  // TODO: add support for multiple key sequences
-  keySequence?: string | string[];
+export interface CommandPreview {
   description?: string;
   command?: string;
   title?: string | (() => string);
   icon?: string | (() => string);
+}
+
+export interface CommandMeta<T = any> extends Partial<CommandPreview> {
+  // TODO: add support for multiple key sequences
+  keySequence?: string | string[];
   /* Where is this command available, default value is global */
   group?: CommandGroup;
   allowOnInput?: boolean;
   ignorePrompt?: boolean;
-
   /* When command is system command, it will not be shown for users */
   system?: boolean;
+  available?: () => boolean;
+  context?: {
+    [key: string]: T;
+  };
+}
+
+export interface Command<T = any> extends CommandMeta<T> {
   /* arguments depend on the current scope */
   handler: (params?: CommandHandlerParams) => unknown | Promise<unknown>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orgnote-api",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Official API for creating extensions for OrgNote app",
   "type": "module",
   "main": "./index.ts",