feat (side panel): add side panel UI skeleton with toggle command

package.json

@@ -7,9 +7,9 @@
     "copyAssets": "node tools/copyAssets.js",
     "updateVersion": "webpack --env joplin-plugin-config=updateVersion",
     "update": "npm install -g generator-joplin && yo joplin --node-package-manager npm --update --force",
-    "lint": "eslint \"src/**/*.ts\"",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\"",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
     "ci": "npm run lint && npm run format:check && npm run dist"
   },
   "license": "MIT",
@@ -21,6 +21,8 @@
   ],
   "devDependencies": {
     "@types/node": "^18.7.13",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
     "@typescript-eslint/eslint-plugin": "^5.62.0",
     "@typescript-eslint/parser": "^5.62.0",
     "chalk": "^4.1.0",
@@ -39,6 +41,8 @@
     "@huggingface/transformers": "^3.8.1",
     "hdbscan-ts": "^1.0.17",
     "js-tiktoken": "^1.0.21",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "umap-js": "^1.4.0",
     "vectra": "^0.12.3"
   }

plugin.config.json

@@ -1,3 +1,3 @@
 {
-	"extraScripts": ["worker/embedWorker.ts"]
+	"extraScripts": ["worker/embedWorker.ts", "webview/panel.tsx"]
 }

src/index.ts

@@ -1,6 +1,8 @@
 import joplin from 'api';
-import { MenuItemLocation } from 'api/types';
+import { MenuItemLocation, ToolbarButtonLocation } from 'api/types';
 import { runTestEmbed } from './commands/testEmbed';
+import { runPipeline } from './pipeline/runPipeline';
+import { PanelMessage, WebviewMessage } from './types/panel';
 import { log } from './utils/logger';
 
 joplin.plugins.register({
@@ -21,6 +23,75 @@ joplin.plugins.register({
 			MenuItemLocation.Tools,
 		);
 
+		// Panel starts hidden; user opens via toolbar button or View menu
+		const panel = await joplin.views.panels.create('aiCategorise.panel');
+		await joplin.views.panels.setHtml(panel, '<div id="root"></div>');
+		await joplin.views.panels.addScript(panel, './webview/panel.css');
+		await joplin.views.panels.addScript(panel, './webview/panel.js');
+		await joplin.views.panels.show(panel, false);
+
+		// Pipeline state shared between the onMessage handler and pipeline callbacks.
+		// The webview polls this state via { type: 'poll' } messages.
+		let panelState: PanelMessage | { type: 'idle' } = { type: 'idle' };
+
+		await joplin.views.panels.onMessage(panel, async (msg: WebviewMessage) => {
+			switch (msg.type) {
+				case 'run':
+					panelState = { type: 'status', text: 'Starting pipeline...' };
+					log('Panel: starting pipeline');
+
+					// Fire-and-forget — pipeline updates panelState via callbacks
+					runPipeline(installDir, {
+						onStatus: (text) => {
+							panelState = { type: 'status', text };
+						},
+						onProgress: (current, total, cached, skipped) => {
+							panelState = { type: 'progress', current, total, cached, skipped };
+						},
+						onComplete: (strategies, notes) => {
+							panelState = { type: 'results', strategies, notes };
+						},
+						onError: (message) => {
+							panelState = { type: 'error', message };
+						},
+					});
+
+					return panelState;
+
+				case 'poll':
+					return panelState;
+
+				case 'openNote':
+					if (msg.noteId) {
+						await joplin.commands.execute('openNote', msg.noteId);
+					}
+					return;
+			}
+		});
+
+		await joplin.commands.register({
+			name: 'aiCategorise.togglePanel',
+			label: 'AI Categorise: Toggle Panel',
+			iconName: 'fas fa-brain',
+			execute: async () => {
+				const visible = await joplin.views.panels.visible(panel);
+				await joplin.views.panels.show(panel, !visible);
+			},
+		});
+
+		await joplin.views.menuItems.create(
+			'aiCategorise.togglePanelMenuItem',
+			'aiCategorise.togglePanel',
+			MenuItemLocation.View,
+		);
+
+		await joplin.views.toolbarButtons.create(
+			'aiCategorise.togglePanelToolbar',
+			'aiCategorise.togglePanel',
+			ToolbarButtonLocation.NoteToolbar,
+		);
+
 		log('Test command registered under Tools menu');
+		log('Panel registered');
 	},
 });