@majkapp/plugin-kit 3.3.3 → 3.3.5

package/README.md

@@ -605,6 +605,10 @@ const plugin = definePlugin('my-plugin', 'My Plugin', '1.0.0');
 
 ## Troubleshooting
 
+### Client Generation Warnings
+
+After running `npm run build`, check `ui/src/generated/generation.log` for schema optimization warnings. The generator analyzes your function input schemas and provides actionable suggestions for improving hook performance (e.g., flattening nested structures, reducing large objects).
+
 ### "React app not built"
 
 ```

package/docs/HOOKS.md

@@ -524,6 +524,11 @@ Generated files (DO NOT EDIT manually):
 - `ui/src/generated/client.ts` - RPC client
 - `ui/src/generated/types.ts` - TypeScript types
 - `ui/src/generated/index.ts` - Barrel export
+- `ui/src/generated/generation.log` - Build log with warnings
+
+### Hook Performance Optimization
+
+Generated hooks use **schema-driven dependency extraction** for optimal performance. Primitive fields (string, number, boolean) are tracked individually via `Object.is()` instead of expensive serialization. Check `generation.log` for dependency analysis and warnings about schema improvements.
 
 ## Next Steps
 

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.
@@ -380,7 +421,7 @@ export class MockStorageService implements StorageService {
 
 ## React UI with Generated Hooks
 
-The plugin-kit auto-generates React hooks from your functions.
+The plugin-kit auto-generates **performance-optimized** React hooks from your functions. Dependencies are extracted from your input schemas for O(1) comparison instead of serialization. Review `ui/src/generated/generation.log` for optimization analysis and schema warnings.
 
 ```typescript
 // ui/src/DashboardPage.tsx

package/package.json

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