@vc-shell/vc-app-skill 2.0.6-pr235.6e1a779 → 2.0.7-pr236.b5ecb25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vc-shell/vc-app-skill",
-  "version": "2.0.6-pr235.6e1a779",
+  "version": "2.0.7-pr236.b5ecb25",
   "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.6
+2.0.7

package/runtime/knowledge/docs/_BUILD_HASH.md

@@ -1 +1 @@
-Synced from framework at commit a3ddbc29a on 2026-05-25T13:00:53.288Z
+Synced from framework at commit 1fb1bd541 on 2026-06-04T07:51:39.317Z

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

@@ -136,6 +136,8 @@ The composable holds an **internal ref** (`_items`) that is the source of truth
 
 This two-way sync avoids reactivity issues when the source is a `WritableComputed` wrapping deeply nested properties (e.g., `item.value.productData.assets`).
 
+**`sortOrder` normalization:** items entering from the source are ordered by their current `sortOrder` (items without one stay stable at the end) and reassigned a clean sequential `sortOrder` (`0..n`). This guarantees every item carries a `sortOrder` for display and reordering even when the source provides them without one. The normalization is idempotent, so it does not loop on the `_sync()` writeback.
+
 ## Types
 
 ### `AssetLike`

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

@@ -62,14 +62,14 @@ None.
 
 ### Returns (`ILanguageService`)
 
-| Property / Method        | Type                                         | Description                                                                                                                                     |
-| ------------------------ | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `currentLocale`          | `ComputedRef<string>`                        | The currently active locale code (e.g., `"en-US"`, `"de-DE"`).                                                                                  |
-| `setLocale`              | `(locale: string) => void`                   | Switches the application locale. This updates `vue-i18n`'s locale and triggers re-rendering of all translated text.                             |
-| `getLocaleByTag`         | `(localeTag: string) => string \| undefined` | Resolves a locale tag to its display string (e.g., `"en-US"` to `"English (United States)"`). Returns `undefined` if the tag is not recognized. |
-| `resolveCamelCaseLocale` | `(locale: string) => string`                 | Converts a locale code to camelCase format (e.g., `"en-US"` to `"enUs"`). Useful for dynamic property access on objects keyed by locale.        |
-| `getFlag`                | `(language: string) => Promise<string>`      | Fetches a flag image URL for the given language/locale. Returns a promise because flags may be loaded lazily.                                   |
-| `getCountryCode`         | `(language: string) => string`               | Extracts the country code from a language tag (e.g., `"en-US"` to `"US"`, `"de-DE"` to `"DE"`).                                                 |
+| Property / Method        | Type                                         | Description                                                                                                                                                                                                                                                                     |
+| ------------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `currentLocale`          | `ComputedRef<string>`                        | The currently active locale code (e.g., `"en-US"`, `"de-DE"`).                                                                                                                                                                                                                  |
+| `setLocale`              | `(locale: string) => void`                   | Switches the application locale. This updates `vue-i18n`'s locale and triggers re-rendering of all translated text.                                                                                                                                                             |
+| `getLocaleByTag`         | `(localeTag: string) => string \| undefined` | Resolves a locale tag to its native display name. Regional tags stay distinct (e.g., `"en-US"` → `"American English"`, `"en-GB"` → `"British English"`); plain codes resolve to the base native name (`"fr"` → `"Français"`). Returns `undefined` if the tag is not recognized. |
+| `resolveCamelCaseLocale` | `(locale: string) => string`                 | Converts a locale code to camelCase format (e.g., `"en-US"` to `"enUs"`). Useful for dynamic property access on objects keyed by locale.                                                                                                                                        |
+| `getFlag`                | `(language: string) => Promise<string>`      | Fetches a flag image URL for the given language/locale. Returns a promise because flags may be loaded lazily.                                                                                                                                                                   |
+| `getCountryCode`         | `(language: string) => string`               | Extracts the country code from a language tag (e.g., `"en-US"` to `"US"`, `"de-DE"` to `"DE"`).                                                                                                                                                                                 |
 
 ### Additional Exports
 

package/runtime/knowledge/docs/core/plugins/ai-agent/ai-agent.docs.md

@@ -7,16 +7,15 @@ slug: ai-agent
 
 # AI Agent Plugin
 
-Integrates an AI assistant panel (chatbot iframe) into the vc-shell application. Provides blade-aware context passing, bidirectional postMessage communication, and preview/apply workflows.
+Integrates an AI assistant panel (chatbot iframe) into the vc-shell application. Provides blade-aware context passing and bidirectional postMessage communication.
 
 ## Overview
 
-The AI agent plugin embeds an external chatbot via an iframe panel that slides in from the right side of the application. It automatically sends the current blade context (user, active blade, selected items) to the chatbot and handles incoming commands (navigate, preview changes, download files). The plugin is optional -- if no `APP_AI_AGENT_URL` environment variable or `config.url` is provided, it silently skips installation.
+The AI agent plugin embeds an external chatbot via an iframe panel that slides in from the right side of the application. It automatically sends the current blade context (user, active blade, selected items) to the chatbot and handles incoming commands (navigate, download files). The plugin is optional -- if no `APP_AI_AGENT_URL` environment variable or `config.url` is provided, it silently skips installation.
 
 ## When to Use
 
 - Embed an AI assistant chatbot panel into your vc-shell application with automatic blade context passing
-- Enable preview/apply workflows where AI suggests changes and the user confirms them
 - When NOT to use: if you don't have an AI agent backend -- the plugin silently skips when no `APP_AI_AGENT_URL` is set
 
 ## Installation / Registration
@@ -88,10 +87,7 @@ Binds blade data to the AI agent context. Call this in each blade that should pa
 | `dataRef`     | `Ref<T> \| Ref<T[]>` | Data to send (single object for details, array for list) |
 | `suggestions` | `ISuggestion[]`      | Custom suggestion cards for the chatbot UI               |
 
-| Return                       | Type                    | Description                                      |
-| ---------------------------- | ----------------------- | ------------------------------------------------ |
-| `previewState.isActive`      | `ComputedRef<boolean>`  | Whether AI-suggested changes are being previewed |
-| `previewState.changedFields` | `ComputedRef<string[]>` | List of field names with pending changes         |
+The composable returns `void`. It wires the watcher and the unmount cleanup; nothing is exposed to the caller.
 
 ### PostMessage Protocol
 
@@ -103,12 +99,9 @@ Binds blade data to the AI agent context. Call this in each blade that should pa
 **Chatbot to Shell:**
 
 - `CHAT_READY` -- Chatbot finished loading
-- `NAVIGATE_TO_APP` -- Open a specific blade
-- `PREVIEW_CHANGES` -- Preview data changes in the form
-- `APPLY_CHANGES` -- Apply confirmed changes
-- `RELOAD_BLADE` -- Reload the current blade
-- `DOWNLOAD_FILE` -- Download a file (base64)
-- `CHAT_ERROR` -- Error from chatbot
+- `NAVIGATE_TO_APP` -- Open a specific blade (driven by markdown action links in assistant messages)
+- `EXPAND_IN_CHAT` -- Expand an item inline in the chat (markdown action link)
+- `SHOW_MORE` -- Request the next page of a result category (markdown action link)
 
 ## Usage
 
@@ -117,7 +110,7 @@ Binds blade data to the AI agent context. Call this in each blade that should pa
 ```typescript
 // In a details blade
 const product = ref<Product>({});
-const { previewState } = useAiAgentContext({
+useAiAgentContext({
   dataRef: product,
   suggestions: [{ id: "translate", title: "Translate", icon: "translation", prompt: "Translate to English" }],
 });
@@ -149,17 +142,6 @@ onMessage((message) => {
 });
 ```
 
-### Preview State Visual Feedback
-
-```vue
-<template>
-  <VcInput
-    v-model="product.name"
-    :class="{ 'ai-preview': previewState.changedFields.value.includes('name') }"
-  />
-</template>
-```
-
 ## Related
 
 - `framework/core/plugins/ai-agent/services/ai-agent-service.ts` -- core service factory (`createAiAgentService`)

package/runtime/knowledge/docs/core/plugins/extension-points/extension-points.docs.md

@@ -130,9 +130,7 @@ Plugins can register components **before** the host declares the extension point
 2. Later, host calls `defineExtensionPoint("seller:commissions")` -- the store upgrades the entry to "declared" and preserves all previously registered components.
 3. The host's `components` computed ref reactively picks up the registered components.
 
-This means module load order does not matter. Remote modules loaded via Module Federation may install in any sequence, and extensions still work.
-
-> **Dev warning:** In development mode, if a plugin registers into a point that is never declared, a console warning appears: `Extension point "xyz" is not declared.` This helps catch typos in extension point names.
+This means module load order does not matter. Remote modules loaded via Module Federation may install in any sequence, and extensions still work. Plugins typically register in module `install()` at app startup, while hosts declare lazily when their page mounts -- an undeclared entry in between is a normal, expected state.
 
 ### Priority-Based Sorting
 
@@ -517,7 +515,7 @@ add({ id: "my-fields", component: MyFields });
 // Component is registered but never rendered because the host declared "seller:commissions"
 ```
 
-The dev-mode console warning (`Extension point "seller:comissions" is not declared`) will alert you to this. Always check the console in development.
+There is no console warning for this case -- registering before a host declares the point is a supported flow, so the framework cannot tell a typo apart from a host page that simply has not been opened yet. The most reliable protection is to avoid string literals altogether:
 
 > **Tip:** Define constants for your extension point names in a shared file:
 >

package/runtime/knowledge/docs/ui/components/organisms/vc-data-table/composables/table-composables.docs.md

@@ -37,7 +37,7 @@ The composables follow a PrimeVue-inspired pattern: each returns reactive state
 
 | Composable               | Purpose                                                                                                                                                                                                                                                         |
 | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `useTableRowReorder`     | Drag-and-drop row reordering with live-swap at 50% vertical threshold. Commits via `dragend` (always fires) with `drop` as preferred path.                                                                                                                      |
+| `useTableRowReorder`     | Drag-and-drop row reordering via SortableJS (touch + mouse). Dragging is restricted to a handle selector. Commits on SortableJS `onEnd` with `{ dragIndex, dropIndex, value }`. Keeps an optimistic `reorderedItems` buffer until the parent updates `items`.   |
 | `useTableColumnsReorder` | Drag-and-drop column reordering with 50% horizontal threshold. Returns `getReorderHeadProps()` for easy binding.                                                                                                                                                |
 | `useTableColumnsResize`  | Weight-based resize: dragging adjusts the weights of the dragged column and its right neighbor without touching other columns. DOM-based px updates during drag for smooth 60fps; commits new weights to `columnState` on mouseup. No `ResizeObserver` scaling. |
 | `useTableSelectionV2`    | Row selection: single, multiple (checkbox), and row-click modes. Emits `RowSelectEvent` / `RowSelectAllEvent`.                                                                                                                                                  |
@@ -160,7 +160,7 @@ register({
 ### Contributor notes
 
 - `useDataTableState`: Guard against save-during-restore loops with the `isRestoring` flag.
-- `useTableRowReorder`: `event.preventDefault()` in `dragover` MUST be called on every event or `drop` never fires.
+- `useTableRowReorder`: powered by SortableJS with `forceFallback: true` so it works on touch. Dragging is limited to the `handle` selector. The optimistic `reorderedItems`/`pendingReorder` buffer makes Vue the source of DOM truth and hides SortableJS's raw DOM mutation until the parent updates `items`.
 - `useTableColumnsResize` applies DOM-level px changes during drag for 60fps performance, then commits final weights to `columnState` on mouseup. No `ResizeObserver` scaling is involved.
 
 <!-- internal:end -->

package/runtime/knowledge/docs/ui/components/organisms/vc-data-table/vc-data-table.docs.md

@@ -641,7 +641,7 @@ When `show-all-columns` is `false`, only `image` and `name` remain visible.
 
 ## Row Reorder
 
-Enable drag-and-drop row reordering with a drag handle column:
+Enable drag-and-drop row reordering. A grip handle appears on the left of each row (desktop) or card (mobile) whenever `reorderable-rows` is enabled, and dragging is initiated from that handle. Reorder works on both desktop and touch devices (powered by SortableJS):
 
 ```vue
 <template>
@@ -678,7 +678,7 @@ function onReorder(event: { dragIndex: number; dropIndex: number; value: Product
 </script>
 ```
 
-> **Tip:** The drag handle column renders a grip icon. Without `row-reorder` on a VcColumn, the entire row is draggable (less precise, but works).
+> **Tip:** Setting `:reorderable-rows="true"` is enough — a grip handle is shown automatically and is the only drag affordance (so row clicks, mobile swipe actions, and long-press selection keep working). A dedicated `:row-reorder` VcColumn is optional and simply reserves an aligned column slot for the handle. On mobile, drag the handle to reorder cards.
 
 ---