All: Use Lerna to manage monorepo

packages/lib/services/plugins/api/JoplinCommands.ts

@@ -0,0 +1,86 @@
+import CommandService, { CommandContext, CommandDeclaration, CommandRuntime } from '../../CommandService';
+import { Command } from './types';
+
+/**
+ * This class allows executing or registering new Joplin commands. Commands
+ * can be executed or associated with
+ * {@link JoplinViewsToolbarButtons | toolbar buttons} or
+ * {@link JoplinViewsMenuItems | menu items}.
+ *
+ * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/register_command)
+ *
+ * ## Executing Joplin's internal commands
+ *
+ * It is also possible to execute internal Joplin's commands which, as of
+ * now, are not well documented. You can find the list directly on GitHub
+ * though at the following locations:
+ *
+ * * [Main screen commands](https://github.com/laurent22/joplin/tree/dev/packages/app-desktop/gui/MainScreen/commands)
+ * * [Global commands](https://github.com/laurent22/joplin/tree/dev/packages/app-desktop/commands)
+ * * [Editor commands](https://github.com/laurent22/joplin/tree/dev/packages/app-desktop/gui/NoteEditor/commands/editorCommandDeclarations.ts)
+ *
+ * To view what arguments are supported, you can open any of these files
+ * and look at the `execute()` command.
+ */
+export default class JoplinCommands {
+
+	/**
+	 * <span class="platform-desktop">desktop</span> Executes the given
+	 * command.
+	 *
+	 * The command can take any number of arguments, and the supported
+	 * arguments will vary based on the command. For custom commands, this
+	 * is the `args` passed to the `execute()` function. For built-in
+	 * commands, you can find the supported arguments by checking the links
+	 * above.
+	 *
+	 * ```typescript
+	 * // Create a new note in the current notebook:
+	 * await joplin.commands.execute('newNote');
+	 *
+	 * // Create a new sub-notebook under the provided notebook
+	 * // Note: internally, notebooks are called "folders".
+	 * await joplin.commands.execute('newFolder', "SOME_FOLDER_ID");
+	 * ```
+	 */
+	async execute(commandName: string, ...args:any[]):Promise<any | void> {
+		return CommandService.instance().execute(commandName, ...args);
+	}
+
+	/**
+	 * <span class="platform-desktop">desktop</span> Registers a new command.
+	 *
+	 * ```typescript
+	 * // Register a new commmand called "testCommand1"
+	 *
+	 * await joplin.commands.register({
+	 *     name: 'testCommand1',
+	 *     label: 'My Test Command 1',
+	 *     iconName: 'fas fa-music',
+	 *     execute: () => {
+	 *         alert('Testing plugin command 1');
+	 *     },
+	 * });
+	 * ```
+	 */
+	async register(command:Command) {
+		const declaration:CommandDeclaration = {
+			name: command.name,
+			label: command.label,
+		};
+
+		if ('iconName' in command) declaration.iconName = command.iconName;
+
+		const runtime:CommandRuntime = {
+			execute: (_context:CommandContext, ...args:any[]) => {
+				return command.execute(...args);
+			},
+		};
+
+		if ('enabledCondition' in command) runtime.enabledCondition = command.enabledCondition;
+
+		CommandService.instance().registerDeclaration(declaration);
+		CommandService.instance().registerRuntime(declaration.name, runtime);
+	}
+
+}