@majkapp/plugin-kit 3.3.3 → 3.3.4

package/docs/INDEX.md

@@ -43,7 +43,8 @@ const plugin = definePlugin('my-plugin', 'My Plugin', '1.0.0')
     name: 'My Plugin',
     description: 'Main plugin screen',
     route: '/plugin-screens/my-plugin/main',
-    pluginPath: '/index.html'  // Path to built React app
+    pluginPath: '/index.html',      // Path to built React app
+    pluginPathHash: '#/'             // Route within React app (HashRouter)
   })
 
   .build();
@@ -228,6 +229,46 @@ export default defineConfig({
 - Empty base ensures assets load correctly
 - `base: './'` will cause 404 errors for assets
 
+### Hash Routing for Multiple Screens
+
+**Use `pluginPathHash` to route to different screens in your React app:**
+
+```typescript
+// Multiple screens using hash routes
+.screenReact({
+  id: 'my-plugin-dashboard',
+  name: 'Dashboard',
+  route: '/plugin-screens/my-plugin/dashboard',
+  pluginPath: '/index.html',
+  pluginPathHash: '#/'           // Main dashboard
+})
+
+.screenReact({
+  id: 'my-plugin-settings',
+  name: 'Settings',
+  route: '/plugin-screens/my-plugin/settings',
+  pluginPath: '/index.html',
+  pluginPathHash: '#/settings'   // Settings page
+})
+```
+
+Your React app (ui/src/App.tsx) uses HashRouter:
+
+```typescript
+import { HashRouter, Routes, Route } from 'react-router-dom';
+
+export function App() {
+  return (
+    <HashRouter>
+      <Routes>
+        <Route path="/" element={<DashboardPage />} />
+        <Route path="/settings" element={<SettingsPage />} />
+      </Routes>
+    </HashRouter>
+  );
+}
+```
+
 ## Best Practice: Decoupled Business Logic
 
 **ALWAYS separate business logic from plugin code.** This makes testing easier and allows logic reuse.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@majkapp/plugin-kit",
-  "version": "3.3.3",
+  "version": "3.3.4",
   "description": "Pure plugin definition library for MAJK - outputs plugin definitions, not HTTP servers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",