@vc-shell/vc-app-skill 2.0.1 → 2.0.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.0.3](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.2...v2.0.3) (2026-04-30)
+
+**Note:** Version bump only for package @vc-shell/vc-app-skill
+
+## [2.0.2](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.1...v2.0.2) (2026-04-27)
+
+**Note:** Version bump only for package @vc-shell/vc-app-skill
+
 ## [2.0.1](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0...v2.0.1) (2026-04-24)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vc-shell/vc-app-skill",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "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.1
+2.0.3

package/runtime/knowledge/docs/_BUILD_HASH.md

@@ -1 +1 @@
-Synced from framework at commit 5f8005c08 on 2026-04-24T08:05:31.316Z
+Synced from framework at commit d658f5b4c on 2026-04-30T07:59:28.391Z

package/runtime/knowledge/docs/injection-keys.docs.md

@@ -19,22 +19,20 @@ This centralized approach has several advantages:
 
 ### Blade Navigation
 
-| Key                         | Type                                   | Description                                  |
-| --------------------------- | -------------------------------------- | -------------------------------------------- |
-| `NavigationViewLocationKey` | `BladeVNode`                           | Current blade VNode location in navigation   |
-| `BladeDescriptorKey`        | `ComputedRef<BladeDescriptor>`         | Current blade descriptor metadata            |
-| `BladeBackButtonKey`        | `Component \| undefined`               | Custom back button component for a blade     |
-| `BladeDataKey`              | _(from blade-navigation types)_        | Data passed between parent/child blades      |
-| `BladeContextKey`           | `ComputedRef<Record<string, unknown>>` | Blade-exposed context for widgets/extensions |
-| `BladeRoutesKey`            | `BladeRoutesRecord[]`                  | Registered blade routes                      |
-| `InternalRoutesKey`         | `BladeRoutesRecord[]`                  | Internal framework routes                    |
+| Key                  | Type                                   | Description                                  |
+| -------------------- | -------------------------------------- | -------------------------------------------- |
+| `BladeDescriptorKey` | `ComputedRef<BladeDescriptor>`         | Current blade descriptor metadata            |
+| `BladeBackButtonKey` | `Component \| undefined`               | Custom back button component for a blade     |
+| `BladeDataKey`       | _(from blade-navigation types)_        | Data passed between parent/child blades      |
+| `BladeContextKey`    | `ComputedRef<Record<string, unknown>>` | Blade-exposed context for widgets/extensions |
+| `BladeRoutesKey`     | `BladeRoutesRecord[]`                  | Registered blade routes                      |
+| `InternalRoutesKey`  | `BladeRoutesRecord[]`                  | Internal framework routes                    |
 
 ### Notifications
 
-| Key                        | Type                                | Description                                 |
-| -------------------------- | ----------------------------------- | ------------------------------------------- |
-| `NotificationTemplatesKey` | `NotificationTemplateConstructor[]` | Registered notification template components |
-| `NotificationStoreKey`     | `NotificationStore`                 | Shared notification store singleton         |
+| Key                    | Type                | Description                         |
+| ---------------------- | ------------------- | ----------------------------------- |
+| `NotificationStoreKey` | `NotificationStore` | Shared notification store singleton |
 
 ### Services
 
@@ -42,7 +40,6 @@ This centralized approach has several advantages:
 | ------------------------------- | ----------------------------- | ------------------------------ |
 | `WidgetServiceKey`              | `IWidgetService`              | Widget registration and lookup |
 | `DashboardServiceKey`           | `IDashboardService`           | Dashboard widget management    |
-| `GlobalSearchKey`               | `GlobalSearchState`           | Global search state            |
 | `MenuServiceKey`                | `MenuService`                 | Main navigation menu           |
 | `SettingsMenuServiceKey`        | `ISettingsMenuService`        | Settings sidebar menu          |
 | `AppBarWidgetServiceKey`        | `IAppBarWidgetService`        | App bar widget slots           |
@@ -81,14 +78,23 @@ This centralized approach has several advantages:
 
 ### Legacy Aliases (Deprecated)
 
-| Deprecated                    | Use Instead                 |
-| ----------------------------- | --------------------------- |
-| `navigationViewLocation`      | `NavigationViewLocationKey` |
-| `BladeDescriptor`             | `BladeDescriptorKey`        |
-| `NotificationTemplatesSymbol` | `NotificationTemplatesKey`  |
-| `BLADE_BACK_BUTTON`           | `BladeBackButtonKey`        |
-| `TOOLBAR_SERVICE`             | `ToolbarServiceKey`         |
-| `EMBEDDED_MODE`               | `EmbeddedModeKey`           |
+| Deprecated          | Use Instead          |
+| ------------------- | -------------------- |
+| `BladeDescriptor`   | `BladeDescriptorKey` |
+| `BLADE_BACK_BUTTON` | `BladeBackButtonKey` |
+| `TOOLBAR_SERVICE`   | `ToolbarServiceKey`  |
+| `EMBEDDED_MODE`     | `EmbeddedModeKey`    |
+
+### Removed Keys (No Replacement)
+
+These keys existed in v1.2.3 but have been removed from the framework entirely. There is no drop-in symbol replacement.
+
+| Removed                       | Notes                                                                          |
+| ----------------------------- | ------------------------------------------------------------------------------ |
+| `navigationViewLocation`      | Internal framework concern — no public replacement                             |
+| `BladeInstance`               | Use `useBlade()` composable, or `inject(BladeDescriptorKey)`                   |
+| `NotificationTemplatesSymbol` | Template system replaced by `NotificationStoreKey` + `useBladeNotifications()` |
+| `GlobalSearchKey`             | Internal concern now — no public replacement                                   |
 
 ## Usage Examples
 

package/runtime/knowledge/docs/shell/dashboard/draggable-dashboard/dashboard-widget-skeleton.docs.md

@@ -0,0 +1,26 @@
+# DashboardWidgetSkeleton
+
+Internal placeholder card used by `GridstackDashboard` while remote modules are still loading. Mimics the shape of `DashboardWidgetCard` (header with icon + title, stats row, content lines) with a shimmer animation. Not exported from `@vc-shell/framework` — consumed only inside the dashboard organism.
+
+## When to Use
+
+- You won't use this directly. `GridstackDashboard` renders one per `SkeletonItem` while `ModulesReadyKey` resolves to `false`.
+- If you build a custom dashboard layout and want the same loading aesthetic, copy this file rather than importing it — the component is intentionally internal so the dashboard team can change its markup at any time.
+
+## Layout Contract
+
+The skeleton has no props. Its parent positions it via inline `style` (`grid-column` / `grid-row`) inside a 12-column CSS grid. Card height/width is fully determined by the grid cell it occupies, so the skeleton stretches to fill its slot.
+
+## Accessibility
+
+- The wrapper has `aria-hidden="true"` so screen readers ignore the visual placeholders. The parent grid carries `role="status"` + `aria-busy="true"` to announce loading state once.
+- Shimmer animation is disabled when the user prefers reduced motion.
+
+## Design Tokens
+
+Skeleton inherits dashboard card tokens where possible (`--dashboard-widget-card-background`, `--dashboard-widget-card-border-color`, `--dashboard-widget-card-border-radius`, `--dashboard-widget-card-shadow`) so its silhouette matches the real card. Shimmer colors are read from `--neutrals-100` / `--neutrals-200`.
+
+## Related
+
+- [DraggableDashboard](./draggable-dashboard.docs.md) — owns the skeleton grid and decides when to render placeholders.
+- [DashboardWidgetCard](../dashboard-widget-card/dashboard-widget-card.docs.md) — the real card whose shape skeletons imitate.

package/runtime/knowledge/docs/shell/dashboard/draggable-dashboard/draggable-dashboard.docs.md

@@ -122,6 +122,8 @@ function resetLayout() {
 - **Widget registration**: Widgets must be registered via `useDashboard().registerWidget()` before the dashboard mounts. The component reads the widget registry and creates grid items for each.
 - **markRaw requirement**: Widget components must be wrapped in `markRaw()` when registering to prevent Vue from making them reactive (which would cause performance issues with the grid system).
 - **Responsive behavior**: On mobile viewports, widgets stack vertically in a single column. Drag-and-drop is disabled on touch devices for better usability.
+- **Module-ready gate**: When the host injects `ModulesReadyKey` (provided by `@vc-shell/mf-host`'s `registerRemoteModules`), the grid is held back until remote modules finish installing. This prevents widgets from mounting before their owning module's `defineAppModule.install` has merged its locales into vue-i18n — which would render translation keys instead of translated strings. Hosts without Module Federation (or tests/Storybook) inject nothing, and a fallback `ref(true)` keeps behavior unchanged.
+- **Loading skeletons**: While `ModulesReadyKey` is `false`, the dashboard renders a CSS-grid of pulsing placeholder cards instead of an empty container. Card sizes are restored from the last persisted layout in `localStorage` (so returning users see placeholders matching their real widgets); first-time visitors get a default layout of four 6×6 placeholders. Animations respect `prefers-reduced-motion`.
 
 ## Tips
 

package/runtime/knowledge/docs/ui/components/molecules/vc-field/vc-field.docs.md

@@ -196,6 +196,15 @@ For read-only display, `VcField` is lighter and cleaner than a disabled `VcInput
 
 The `type` prop affects rendering, not validation. Setting `type="email"` does not validate the email format -- it only renders the value as a `mailto:` link. For input validation, use VcInput with validation rules.
 
+## Horizontal Layout Without Label
+
+In `orientation="horizontal"` the component reserves the `aspectRatio[0]` track even when `label` is omitted. This keeps a column of `VcField`s aligned with their labeled siblings in a form grid. Use vertical orientation if you do not want this reservation.
+
+```vue
+<!-- Reserves the label column to align with sibling fields -->
+<VcField orientation="horizontal" :aspect-ratio="[1, 2]" model-value="No label" />
+```
+
 ## Related Components
 
 - [VcInput](../vc-input/) -- editable text field (use instead when user input is needed)