mvc-kit 2.11.0 → 2.11.1

package/agent-config/claude-code/skills/guide/patterns.md

@@ -495,6 +495,18 @@ class CartViewModel extends ViewModel<CartState> {
 const [state, vm] = useSingleton(CartViewModel);
 ```
 
+**Convenience hooks** (optional): For singletons used in many components, co-export a hook from the ViewModel file:
+```typescript
+// viewmodels/AuthViewModel.ts
+export class AuthViewModel extends ViewModel<AuthState> { ... }
+export const useAuth = () => useSingleton(AuthViewModel);
+
+// components/Header.tsx — single import
+import { useAuth } from '../viewmodels/AuthViewModel';
+const [state, vm] = useAuth();
+```
+Use sparingly (2–3 app-wide singletons). The class stays framework-agnostic.
+
 **Pattern C — Shared Collection** (different views of same data):
 ```tsx
 // UsersTable uses UsersViewModel → subscribes to UsersCollection

package/agent-config/copilot/copilot-instructions.md

@@ -213,7 +213,7 @@ class UsersListVM extends ViewModel<FilterState> {
 ## Sharing Patterns
 
 1. **Pattern A** (default): Parent ViewModel passes props to presentational children
-2. **Pattern B**: Singleton ViewModel via `useSingleton` for app-wide state (define `static DEFAULT_STATE` for arg-free calls)
+2. **Pattern B**: Singleton ViewModel via `useSingleton` for app-wide state (define `static DEFAULT_STATE` for arg-free calls). For singletons used in many components, optionally co-export a convenience hook: `export const useAuth = () => useSingleton(AuthViewModel);` -- keeps the class framework-agnostic while reducing imports at call sites. Use sparingly (2--3 app-wide singletons).
 3. **Pattern C**: Separate ViewModels sharing a singleton Collection
 
 ## ViewModel Events

package/agent-config/cursor/cursorrules

@@ -213,7 +213,7 @@ class UsersListVM extends ViewModel<FilterState> {
 ## Sharing Patterns
 
 1. **Pattern A** (default): Parent ViewModel passes props to presentational children
-2. **Pattern B**: Singleton ViewModel via `useSingleton` for app-wide state (define `static DEFAULT_STATE` for arg-free calls)
+2. **Pattern B**: Singleton ViewModel via `useSingleton` for app-wide state (define `static DEFAULT_STATE` for arg-free calls). For singletons used in many components, optionally co-export a convenience hook: `export const useAuth = () => useSingleton(AuthViewModel);` — keeps the class framework-agnostic while reducing imports at call sites. Use sparingly (2–3 app-wide singletons).
 3. **Pattern C**: Separate ViewModels sharing a singleton Collection
 
 ## ViewModel Events

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mvc-kit",
-  "version": "2.11.0",
+  "version": "2.11.1",
   "description": "Zero-magic, class-based reactive ViewModel library",
   "type": "module",
   "main": "./dist/mvc-kit.cjs",
@@ -11,6 +11,7 @@
     "dev:fullapp": "vite --config examples/react/FullApp/vite.config.ts",
     "dev:complexapp": "vite --config examples/react/ComplexApp/vite.config.ts",
     "dev:workerapp": "vite --config examples/react/WorkerApp/vite.config.ts",
+    "dev:authexample": "vite --config examples/react/AuthExample/vite.config.ts",
     "build": "rm -rf dist && tsc -p tsconfig.build.json && vite build",
     "postinstall": "node agent-config/bin/postinstall.mjs",
     "test": "vitest run",