@vc-shell/vc-app-skill 2.0.0-pr221.637b802 → 2.0.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [2.0.1](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0...v2.0.1) (2026-04-24)
+
+### Features
+
+- enhance migrate transforms, fix notification race condition, update migration docs (#221) ([3c2134d](https://github.com/VirtoCommerce/vc-shell/commit/3c2134d0fa1016a2e4e075a12bb9df9a31b3d381)), closes [#221](https://github.com/VirtoCommerce/vc-shell/issues/221)
+
+### Bug Fixes
+
+- **hooks:** update npm version retrieval in vc-app-check-update.js ([c8f0e68](https://github.com/VirtoCommerce/vc-shell/commit/c8f0e68ded994bdfb8d01dcf96e90184b9d278cd))
+
 # [2.0.0](https://github.com/VirtoCommerce/vc-shell/compare/v1.2.3...v2.0.0) (2026-04-22)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vc-shell/vc-app-skill",
-  "version": "2.0.0-pr221.637b802",
+  "version": "2.0.1",
   "description": "AI coding skill for scaffolding and generating VirtoCommerce Shell applications. Works with Claude Code, OpenCode, Gemini, Codex, Cursor.",
   "bin": "./bin/install.cjs",
   "files": [

package/runtime/VERSION

@@ -1 +1 @@
-2.0.0
+2.0.1

package/runtime/knowledge/docs/_BUILD_HASH.md

@@ -1 +1 @@
-Synced from framework at commit be4d05add on 2026-04-22T12:54:33.589Z
+Synced from framework at commit 5f8005c08 on 2026-04-24T08:05:31.316Z

package/runtime/knowledge/docs/core/composables/usePlatformLocaleSync/usePlatformLocaleSync.docs.md

@@ -0,0 +1,28 @@
+# usePlatformLocaleSync
+
+One-way reactive bridge from the VirtoCommerce platform's locale storage key (`NG_TRANSLATE_LANG_KEY`, set by AngularJS + angular-translate) to the shell's language service.
+
+Call this composable only when the shell runs embedded inside the platform — `useShellBootstrap` invokes it automatically when `options.isEmbedded === true`. In standalone mode the shell owns its own locale via `VC_LANGUAGE_SETTINGS`, and this composable should not be used.
+
+## When to Use
+
+- Never call directly from feature code. This is a framework-internal sync primitive.
+- It is invoked once per `VcApp` mount from `useShellBootstrap`.
+
+## Behaviour
+
+- Reads `localStorage["NG_TRANSLATE_LANG_KEY"]` via VueUse's `useLocalStorage`, which subscribes to `storage` events for cross-tab reactivity.
+- On setup, if the value is non-empty, calls `LanguageService.setLocale(value)`. `setLocale` normalises the value (e.g. `en-US` → `en-us`), falls back to `en` for unsupported locales, updates `vue-i18n`, reconfigures `vee-validate`, and persists to `VC_LANGUAGE_SETTINGS`.
+- On subsequent changes of the platform key, re-applies the value.
+- Skips empty strings (platform clearing the key does not blank the shell locale).
+- Skips values equal to `currentLocale` to avoid redundant re-configuration.
+
+## How It Works
+
+`useLocalStorage("NG_TRANSLATE_LANG_KEY", "")` returns a `Ref<string>` that VueUse keeps in sync with `localStorage` and the DOM `storage` event (which fires in tabs other than the writer). The composable applies the current ref value once synchronously and then registers a `watch` on it; any cross-tab mutation flows through the ref into `setLocale`.
+
+The watcher is bound to the active effect scope (typically `VcApp`'s setup). When `VcApp` unmounts, the watcher stops; `useLocalStorage` cleans up its own `storage` listener.
+
+## Relationship to `VC_LANGUAGE_SETTINGS`
+
+The sync is strictly one-directional. `setLocale` writes to `VC_LANGUAGE_SETTINGS` as a side effect, but this composable never writes to `NG_TRANSLATE_LANG_KEY`. In embedded mode the in-shell `LanguageSelector` is unreachable (it lives inside `UserDropdownButton`, which is hidden when `isEmbedded` is `true`), so there is no competing writer from the shell side.

package/runtime/knowledge/docs/core/notifications/notifications.docs.md

@@ -17,7 +17,12 @@ The notification system receives `PushNotification` messages from the platform S
 ```
 PushNotification (SignalR)
         |
-        v
+  ┌─────┴─────┐
+  Send     SendSystemEvents
+  |            |
+  |     broadcastFilter?
+  |            |
+  v            v
   NotificationStore.ingest()
         |
         +---> history[]  (persistent, loaded from API)
@@ -47,7 +52,9 @@ Returns the shared `NotificationStore` singleton. Resolution order:
 | `unreadCount`                | `ComputedRef<number>`                        | Count of unread notifications in history                             |
 | `hasUnread`                  | `ComputedRef<boolean>`                       | Whether any unread notifications exist                               |
 | `registerType(type, config)` | `(string, NotificationTypeConfig) => void`   | Register a notification type with toast/template config              |
-| `ingest(message)`            | `(PushNotification) => void`                 | Process an incoming notification (upsert, toast, notify subscribers) |
+| `ingest(message, opts?)`     | `(PushNotification, {broadcast?}?) => void`  | Process an incoming notification; broadcast messages are filtered    |
+| `setBroadcastFilter(fn)`     | `((PushNotification) => boolean) => void`    | Set filter for broadcast messages (SendSystemEvents)                 |
+| `clearBroadcastFilter()`     | `() => void`                                 | Remove the broadcast filter                                          |
 | `markAsRead(message)`        | `(PushNotification) => void`                 | Mark a single notification as read                                   |
 | `markAllAsRead()`            | `() => Promise<void>`                        | Optimistic mark-all-as-read with server sync and rollback on failure |
 | `loadHistory(take?)`         | `(number?) => Promise<void>`                 | Load notification history from the API (default: 10)                 |
@@ -105,6 +112,35 @@ const notificationRef = useNotificationContext<IOrderNotification>();
 // notificationRef.value.orderId, notificationRef.value.title, etc.
 ```
 
+### `useBroadcastFilter()`
+
+Controls which broadcast push notifications (`SendSystemEvents`) are accepted by the store. Targeted notifications (`Send`) are always accepted regardless of filter.
+
+**File:** `composables/useBroadcastFilter.ts`
+
+#### Returns
+
+```typescript
+interface UseBroadcastFilterReturn {
+  setBroadcastFilter(fn: (msg: PushNotification) => boolean): void;
+  clearBroadcastFilter(): void;
+}
+```
+
+#### Example
+
+```typescript
+import { useBroadcastFilter } from "@vc-shell/framework";
+
+const { setBroadcastFilter, clearBroadcastFilter } = useBroadcastFilter();
+
+// Accept only notifications for the current seller
+setBroadcastFilter((msg) => msg.creator === currentSellerId);
+
+// Remove filter (accept all broadcast messages)
+clearBroadcastFilter();
+```
+
 ### Toast Controller
 
 Handles toast popup display based on `NotificationTypeConfig.toast` settings. Created internally by the store.