@vc-shell/vc-app-skill 2.0.0-alpha.32 → 2.0.0-alpha.33-pr220.455e322

package/runtime/knowledge/docs/core/directives/autofocus/autofocus.docs.md

@@ -12,8 +12,8 @@ The directive is registered globally by the framework, so no manual import is ne
 
 ## API
 
-| Binding | Type | Description |
-|---------|------|-------------|
+| Binding                   | Type      | Description                                         |
+| ------------------------- | --------- | --------------------------------------------------- |
 | `v-autofocus="condition"` | `boolean` | Focus the element on mount if `condition` is truthy |
 
 The directive only acts on the `mounted` hook. It does not re-focus on updates.
@@ -40,7 +40,10 @@ export const autofocus = {
 ```vue
 <template>
   <!-- The search field gets focus as soon as the blade opens -->
-  <input v-autofocus="true" placeholder="Search orders..." />
+  <input
+    v-autofocus="true"
+    placeholder="Search orders..."
+  />
 </template>
 ```
 
@@ -68,7 +71,10 @@ const isEditMode = computed(() => !!props.param);
 
 ```vue
 <template>
-  <VcPopup v-model:show="showDialog" title="Rename Item">
+  <VcPopup
+    v-model:show="showDialog"
+    title="Rename Item"
+  >
     <VcInput
       v-autofocus="showDialog"
       v-model="newName"

package/runtime/knowledge/docs/core/directives/loading/loading.docs.md

@@ -14,20 +14,20 @@ Unlike a standalone loading component, `v-loading` scopes the overlay to the ele
 
 ## API
 
-| Binding | Type | Description |
-|---------|------|-------------|
-| `v-loading="true"` | `boolean` | Show/hide the loading overlay |
-| `v-loading="options"` | `LoadingOptions` | Show with configuration (see below) |
-| `v-loading:1000="true"` | `arg: string` | Set custom z-index (default: `9999`) |
+| Binding                 | Type             | Description                          |
+| ----------------------- | ---------------- | ------------------------------------ |
+| `v-loading="true"`      | `boolean`        | Show/hide the loading overlay        |
+| `v-loading="options"`   | `LoadingOptions` | Show with configuration (see below)  |
+| `v-loading:1000="true"` | `arg: string`    | Set custom z-index (default: `9999`) |
 
 ### LoadingOptions
 
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| `size` | `"small" \| "medium" \| "large"` | -- | Spinner size via `data-loading-size` attribute |
-| `color` | `string` | -- | Custom spinner color (sets `--v-loading-spinner-color`) |
-| `blur` | `boolean` | `true` | Enable backdrop blur; `false` adds `v-loading--no-blur` |
-| `fullscreen` | `boolean` | `false` | Fullscreen overlay via `v-loading--fullscreen` |
+| Property     | Type                             | Default | Description                                             |
+| ------------ | -------------------------------- | ------- | ------------------------------------------------------- |
+| `size`       | `"small" \| "medium" \| "large"` | --      | Spinner size via `data-loading-size` attribute          |
+| `color`      | `string`                         | --      | Custom spinner color (sets `--v-loading-spinner-color`) |
+| `blur`       | `boolean`                        | `true`  | Enable backdrop blur; `false` adds `v-loading--no-blur` |
+| `fullscreen` | `boolean`                        | `false` | Fullscreen overlay via `v-loading--fullscreen`          |
 
 ## How It Works
 
@@ -45,7 +45,10 @@ Because the directive modifies the element directly (not through Vue reactivity)
 
 ```vue
 <template>
-  <div v-loading="isLoading" class="tw-min-h-[200px]">
+  <div
+    v-loading="isLoading"
+    class="tw-min-h-[200px]"
+  >
     <p>Order details will appear here</p>
   </div>
 </template>
@@ -72,7 +75,10 @@ async function loadOrder() {
 <template>
   <!-- Small spinner with brand color, no blur -->
   <div v-loading="{ size: 'small', color: 'var(--primary-500)', blur: false }">
-    <img :src="thumbnailUrl" alt="Product thumbnail" />
+    <img
+      :src="thumbnailUrl"
+      alt="Product thumbnail"
+    />
   </div>
 </template>
 ```
@@ -104,9 +110,18 @@ async function loadOrder() {
 
 ```vue
 <template>
-  <VcBlade title="Products" :closable="true">
-    <div v-loading="loading" class="tw-p-4">
-      <VcDataTable :items="products" :columns="columns" />
+  <VcBlade
+    title="Products"
+    :closable="true"
+  >
+    <div
+      v-loading="loading"
+      class="tw-p-4"
+    >
+      <VcDataTable
+        :items="products"
+        :columns="columns"
+      />
     </div>
   </VcBlade>
 </template>
@@ -146,10 +161,10 @@ Passing an options object when you want to hide the spinner does not work as exp
 
 ## CSS Classes Reference
 
-| Class | Applied When | Effect |
-|-------|-------------|--------|
-| `v-loading` | Value is truthy | Shows the spinner overlay |
-| `v-loading--no-blur` | `blur: false` | Disables backdrop blur filter |
+| Class                   | Applied When       | Effect                             |
+| ----------------------- | ------------------ | ---------------------------------- |
+| `v-loading`             | Value is truthy    | Shows the spinner overlay          |
+| `v-loading--no-blur`    | `blur: false`      | Disables backdrop blur filter      |
 | `v-loading--fullscreen` | `fullscreen: true` | Overlay covers the entire viewport |
 
 ## Related

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

@@ -31,6 +31,7 @@ PushNotification (SignalR)
 ### `useNotificationStore()`
 
 Returns the shared `NotificationStore` singleton. Resolution order:
+
 1. Vue `inject()` (inside component setup or `app.runWithContext()`)
 2. Module-level singleton fallback (ensures microfrontend modules share state)
 
@@ -38,20 +39,20 @@ Returns the shared `NotificationStore` singleton. Resolution order:
 
 ### `NotificationStore` Interface
 
-| Member | Type | Description |
-|--------|------|-------------|
-| `registry` | `Map<string, NotificationTypeConfig>` | Registered notification type configurations |
-| `history` | `Ref<PushNotification[]>` | All notifications (loaded from API + ingested) |
-| `realtime` | `Ref<PushNotification[]>` | Session-only notifications from SignalR |
-| `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) |
-| `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) |
-| `subscribe(opts)` | `({types, filter?, handler?}) => () => void` | Subscribe to notification types; returns unsubscribe function |
-| `getByType(type)` | `(string) => PushNotification[]` | Filter history by `notifyType` |
+| Member                       | Type                                         | Description                                                          |
+| ---------------------------- | -------------------------------------------- | -------------------------------------------------------------------- |
+| `registry`                   | `Map<string, NotificationTypeConfig>`        | Registered notification type configurations                          |
+| `history`                    | `Ref<PushNotification[]>`                    | All notifications (loaded from API + ingested)                       |
+| `realtime`                   | `Ref<PushNotification[]>`                    | Session-only notifications from SignalR                              |
+| `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) |
+| `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)                 |
+| `subscribe(opts)`            | `({types, filter?, handler?}) => () => void` | Subscribe to notification types; returns unsubscribe function        |
+| `getByType(type)`            | `(string) => PushNotification[]`             | Filter history by `notifyType`                                       |
 
 **File:** `store.ts`
 
@@ -65,9 +66,9 @@ Blade-level notification subscription (Level 2). Automatically unsubscribes when
 
 ```typescript
 interface BladeNotificationOptions<T extends PushNotification> {
-  types: string[];                // Notification types to subscribe to
-  filter?: (msg: T) => boolean;   // Optional message filter
-  onMessage?: (msg: T) => void;   // Callback for each matching message
+  types: string[]; // Notification types to subscribe to
+  filter?: (msg: T) => boolean; // Optional message filter
+  onMessage?: (msg: T) => void; // Callback for each matching message
 }
 ```
 
@@ -75,9 +76,9 @@ interface BladeNotificationOptions<T extends PushNotification> {
 
 ```typescript
 interface BladeNotificationReturn<T extends PushNotification> {
-  messages: ComputedRef<T[]>;     // Filtered unread messages from realtime
+  messages: ComputedRef<T[]>; // Filtered unread messages from realtime
   unreadCount: ComputedRef<number>; // Count of matching unread messages
-  markAsRead: (msg: T) => void;   // Mark a specific message as read
+  markAsRead: (msg: T) => void; // Mark a specific message as read
 }
 ```
 
@@ -112,26 +113,26 @@ Handles toast popup display based on `NotificationTypeConfig.toast` settings. Cr
 
 #### Toast Modes
 
-| Mode | Behavior |
-|------|----------|
-| `"auto"` | Single fire-and-forget toast with severity-based timeout |
+| Mode         | Behavior                                                                                    |
+| ------------ | ------------------------------------------------------------------------------------------- |
+| `"auto"`     | Single fire-and-forget toast with severity-based timeout                                    |
 | `"progress"` | Persistent toast updated on each message; auto-completes when `isComplete()` returns `true` |
-| `"silent"` | No toast displayed |
+| `"silent"`   | No toast displayed                                                                          |
 
 ### Types
 
 **File:** `types.ts`
 
-| Type | Description |
-|------|-------------|
-| `Severity` | `"info" \| "warning" \| "error" \| "critical"` |
-| `ToastConfig` | Toast behavior: mode, severity (static or function), timeout, isComplete, completedType |
-| `NotificationTypeConfig` | Per-type config: optional Vue `template` component, `toast` config, `groupBy` field |
-| `ModuleNotificationsConfig` | Record mapping `notifyType` strings to `NotificationTypeConfig` |
-| `NotificationAction` | Action button in notification UI: label, icon, handler, visibility |
-| `NotificationSubscription` | Internal subscriber record: id, types, filter, handler |
-| `SEVERITY_TIMEOUTS` | Default timeouts: info=5s, warning=8s, error=persistent, critical=persistent |
-| `EXCLUDED_NOTIFICATION_TYPES` | Types excluded from ingestion (e.g. `"IndexProgressPushNotification"`) |
+| Type                          | Description                                                                             |
+| ----------------------------- | --------------------------------------------------------------------------------------- |
+| `Severity`                    | `"info" \| "warning" \| "error" \| "critical"`                                          |
+| `ToastConfig`                 | Toast behavior: mode, severity (static or function), timeout, isComplete, completedType |
+| `NotificationTypeConfig`      | Per-type config: optional Vue `template` component, `toast` config, `groupBy` field     |
+| `ModuleNotificationsConfig`   | Record mapping `notifyType` strings to `NotificationTypeConfig`                         |
+| `NotificationAction`          | Action button in notification UI: label, icon, handler, visibility                      |
+| `NotificationSubscription`    | Internal subscriber record: id, types, filter, handler                                  |
+| `SEVERITY_TIMEOUTS`           | Default timeouts: info=5s, warning=8s, error=persistent, critical=persistent            |
+| `EXCLUDED_NOTIFICATION_TYPES` | Types excluded from ingestion (e.g. `"IndexProgressPushNotification"`)                  |
 
 ## Usage Examples
 
@@ -155,9 +156,9 @@ store.registerType("CatalogExportCompleted", {
   template: ExportNotificationTemplate,
   toast: {
     mode: "progress",
-    severity: (msg) => msg.finished ? "info" : "warning",
+    severity: (msg) => (msg.finished ? "info" : "warning"),
     isComplete: (msg) => !!msg.finished,
-    completedType: (msg) => msg.errorCount ? "error" : "success",
+    completedType: (msg) => (msg.errorCount ? "error" : "success"),
   },
   groupBy: "jobId",
 });

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

@@ -36,63 +36,65 @@ app.use(aiAgentPlugin, {
 
 ### Plugin Options: `AiAgentPluginOptions`
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `config` | `Partial<IAiAgentConfig>` | `{}` | Panel configuration (see below) |
-| `addGlobalToolbarButton` | `boolean` | `true` | Adds an AI button to every blade's toolbar |
+| Option                   | Type                      | Default | Description                                |
+| ------------------------ | ------------------------- | ------- | ------------------------------------------ |
+| `config`                 | `Partial<IAiAgentConfig>` | `{}`    | Panel configuration (see below)            |
+| `addGlobalToolbarButton` | `boolean`                 | `true`  | Adds an AI button to every blade's toolbar |
 
 ### `IAiAgentConfig`
 
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `url` | `string` | `""` | Chatbot iframe URL (required) |
-| `title` | `string` | `"Virto OZ"` | Panel header title |
-| `width` | `number` | `362` | Panel width in pixels |
-| `expandedWidth` | `number` | `500` | Panel width when expanded |
-| `allowedOrigins` | `string[]` | `["*"]` | Allowed origins for postMessage validation |
+| Field            | Type       | Default      | Description                                |
+| ---------------- | ---------- | ------------ | ------------------------------------------ |
+| `url`            | `string`   | `""`         | Chatbot iframe URL (required)              |
+| `title`          | `string`   | `"Virto OZ"` | Panel header title                         |
+| `width`          | `number`   | `362`        | Panel width in pixels                      |
+| `expandedWidth`  | `number`   | `500`        | Panel width when expanded                  |
+| `allowedOrigins` | `string[]` | `["*"]`      | Allowed origins for postMessage validation |
 
 ### Composable: `useAiAgent()`
 
 Access the AI agent service from any component within the app.
 
-| Return | Type | Description |
-|--------|------|-------------|
-| `panelState` | `Ref<"closed" \| "open" \| "expanded">` | Current panel state |
-| `isOpen` | `ComputedRef<boolean>` | Whether the panel is visible |
-| `isExpanded` | `ComputedRef<boolean>` | Whether the panel is in expanded mode |
-| `totalItemsCount` | `ComputedRef<number>` | Number of context items |
-| `config` | `Ref<IAiAgentConfig>` | Current configuration |
-| `context` | `ComputedRef<IAiAgentContext>` | Full reactive context |
-| `openPanel()` | `() => void` | Open the AI panel |
-| `closePanel()` | `() => void` | Close the AI panel |
-| `togglePanel()` | `() => void` | Toggle open/close |
-| `expandPanel()` | `() => void` | Expand to larger width |
-| `collapsePanel()` | `() => void` | Collapse to normal width |
-| `setConfig()` | `(config: Partial<IAiAgentConfig>) => void` | Update configuration |
-| `sendMessage()` | `(type, payload) => void` | Send message to chatbot iframe |
-| `onMessage()` | `(handler) => () => void` | Register message handler (returns unsubscribe) |
+| Return            | Type                                        | Description                                    |
+| ----------------- | ------------------------------------------- | ---------------------------------------------- |
+| `panelState`      | `Ref<"closed" \| "open" \| "expanded">`     | Current panel state                            |
+| `isOpen`          | `ComputedRef<boolean>`                      | Whether the panel is visible                   |
+| `isExpanded`      | `ComputedRef<boolean>`                      | Whether the panel is in expanded mode          |
+| `totalItemsCount` | `ComputedRef<number>`                       | Number of context items                        |
+| `config`          | `Ref<IAiAgentConfig>`                       | Current configuration                          |
+| `context`         | `ComputedRef<IAiAgentContext>`              | Full reactive context                          |
+| `openPanel()`     | `() => void`                                | Open the AI panel                              |
+| `closePanel()`    | `() => void`                                | Close the AI panel                             |
+| `togglePanel()`   | `() => void`                                | Toggle open/close                              |
+| `expandPanel()`   | `() => void`                                | Expand to larger width                         |
+| `collapsePanel()` | `() => void`                                | Collapse to normal width                       |
+| `setConfig()`     | `(config: Partial<IAiAgentConfig>) => void` | Update configuration                           |
+| `sendMessage()`   | `(type, payload) => void`                   | Send message to chatbot iframe                 |
+| `onMessage()`     | `(handler) => () => void`                   | Register message handler (returns unsubscribe) |
 
 ### Composable: `useAiAgentContext(options)`
 
 Binds blade data to the AI agent context. Call this in each blade that should participate in AI interactions.
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `dataRef` | `Ref<T> \| Ref<T[]>` | Data to send (single object for details, array for list) |
-| `suggestions` | `ISuggestion[]` | Custom suggestion cards for the chatbot UI |
+| Option        | Type                 | Description                                              |
+| ------------- | -------------------- | -------------------------------------------------------- |
+| `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 |
+| 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         |
 
 ### PostMessage Protocol
 
 **Shell to Chatbot:**
+
 - `INIT_CONTEXT` -- Initial context when chatbot loads (user, blade, items, suggestions, token)
 - `UPDATE_CONTEXT` -- Context updates when blade/items change
 
 **Chatbot to Shell:**
+
 - `CHAT_READY` -- Chatbot finished loading
 - `NAVIGATE_TO_APP` -- Open a specific blade
 - `PREVIEW_CHANGES` -- Preview data changes in the form
@@ -110,9 +112,7 @@ Binds blade data to the AI agent context. Call this in each blade that should pa
 const product = ref<Product>({});
 const { previewState } = useAiAgentContext({
   dataRef: product,
-  suggestions: [
-    { id: "translate", title: "Translate", icon: "translation", prompt: "Translate to English" },
-  ],
+  suggestions: [{ id: "translate", title: "Translate", icon: "translation", prompt: "Translate to English" }],
 });
 
 // In a list blade