@vc-shell/vc-app-skill 2.0.0-alpha.33 → 2.0.0-alpha.34

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

@@ -8,42 +8,42 @@ The utilities module provides a collection of commonly needed functions: string
 
 ## String Utilities
 
-| Function | Signature | Description |
-|----------|-----------|-------------|
-| `camelToSnake` | `(str: string) => string` | Converts camelCase to snake_case |
-| `camelize` | `(str: string) => string` | Converts delimited string to camelCase (splits on non-word chars) |
-| `kebabToCamel` | `(str: string) => string` | Converts kebab-case to camelCase |
-| `kebabToPascal` | `(str: string) => string` | Converts kebab-case to PascalCase |
+| Function        | Signature                 | Description                                                       |
+| --------------- | ------------------------- | ----------------------------------------------------------------- |
+| `camelToSnake`  | `(str: string) => string` | Converts camelCase to snake_case                                  |
+| `camelize`      | `(str: string) => string` | Converts delimited string to camelCase (splits on non-word chars) |
+| `kebabToCamel`  | `(str: string) => string` | Converts kebab-case to camelCase                                  |
+| `kebabToPascal` | `(str: string) => string` | Converts kebab-case to PascalCase                                 |
 
 ### String utility examples
 
 ```typescript
 import { camelToSnake, camelize, kebabToCamel, kebabToPascal } from "@vc-shell/framework";
 
-camelToSnake("myPropName");          // "my_prop_name"
-camelToSnake("backgroundColor");     // "background_color"
+camelToSnake("myPropName"); // "my_prop_name"
+camelToSnake("backgroundColor"); // "background_color"
 
-camelize("some-prop-name");          // "somePropName"
-camelize("SOME_CONSTANT");          // "sOMECONSTANT" (splits on non-word chars)
+camelize("some-prop-name"); // "somePropName"
+camelize("SOME_CONSTANT"); // "sOMECONSTANT" (splits on non-word chars)
 
-kebabToCamel("vc-data-table");       // "vcDataTable"
-kebabToCamel("my-component-name");   // "myComponentName"
+kebabToCamel("vc-data-table"); // "vcDataTable"
+kebabToCamel("my-component-name"); // "myComponentName"
 
-kebabToPascal("vc-data-table");      // "VcDataTable"
-kebabToPascal("dashboard-widget");   // "DashboardWidget"
+kebabToPascal("vc-data-table"); // "VcDataTable"
+kebabToPascal("dashboard-widget"); // "DashboardWidget"
 ```
 
 ## Date Utilities
 
 Located in `date/`. Uses `date-fns` internally with lazy locale loading.
 
-| Function | Signature | Description |
-|----------|-----------|-------------|
-| `formatDateRelative` | `(value: DateInput, localeCode?: string) => string` | Formats date as relative time (e.g. "3 hours ago") via `formatDistanceToNow` |
-| `formatDateWithPattern` | `(value: DateInput, momentFormatStr: string, localeCode?: string) => string` | Formats date using a Moment.js-style format string, auto-converted to date-fns tokens |
-| `convertMomentFormat` | `(momentFormat: string) => string` | Converts a Moment.js format string to date-fns format (e.g. `YYYY` to `yyyy`, `DD` to `dd`) |
-| `resolveLocale` | `(localeCode: string) => Promise<Locale>` | Async-loads a date-fns locale by code, with fallback to base language then `enUS` |
-| `resolveLocaleSync` | `(localeCode: string) => Locale` | Returns cached locale synchronously; triggers async load if missing, returns `enUS` as fallback |
+| Function                | Signature                                                                    | Description                                                                                     |
+| ----------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| `formatDateRelative`    | `(value: DateInput, localeCode?: string) => string`                          | Formats date as relative time (e.g. "3 hours ago") via `formatDistanceToNow`                    |
+| `formatDateWithPattern` | `(value: DateInput, momentFormatStr: string, localeCode?: string) => string` | Formats date using a Moment.js-style format string, auto-converted to date-fns tokens           |
+| `convertMomentFormat`   | `(momentFormat: string) => string`                                           | Converts a Moment.js format string to date-fns format (e.g. `YYYY` to `yyyy`, `DD` to `dd`)     |
+| `resolveLocale`         | `(localeCode: string) => Promise<Locale>`                                    | Async-loads a date-fns locale by code, with fallback to base language then `enUS`               |
+| `resolveLocaleSync`     | `(localeCode: string) => Locale`                                             | Returns cached locale synchronously; triggers async load if missing, returns `enUS` as fallback |
 
 `DateInput` is `string | number | Date | null | undefined`.
 
@@ -53,46 +53,46 @@ Located in `date/`. Uses `date-fns` internally with lazy locale loading.
 import { formatDateRelative, formatDateWithPattern, convertMomentFormat } from "@vc-shell/framework";
 
 // Relative time
-formatDateRelative("2024-01-15");                    // "about 2 years ago"
-formatDateRelative(new Date(Date.now() - 3600000));  // "about 1 hour ago"
-formatDateRelative("2024-01-15", "de");              // "vor etwa 2 Jahren"
+formatDateRelative("2024-01-15"); // "about 2 years ago"
+formatDateRelative(new Date(Date.now() - 3600000)); // "about 1 hour ago"
+formatDateRelative("2024-01-15", "de"); // "vor etwa 2 Jahren"
 
 // Formatted dates using Moment.js-style patterns (auto-converted to date-fns)
-formatDateWithPattern("2024-01-15", "LL");           // "January 15, 2024"
-formatDateWithPattern("2024-06-01", "DD/MM/YYYY");   // "01/06/2024"
-formatDateWithPattern("2024-01-15", "LL", "de");     // "15. Januar 2024"
+formatDateWithPattern("2024-01-15", "LL"); // "January 15, 2024"
+formatDateWithPattern("2024-06-01", "DD/MM/YYYY"); // "01/06/2024"
+formatDateWithPattern("2024-01-15", "LL", "de"); // "15. Januar 2024"
 
 // Format conversion
-convertMomentFormat("YYYY-MM-DD");   // "yyyy-MM-dd"
-convertMomentFormat("DD/MM/YYYY");   // "dd/MM/yyyy"
-convertMomentFormat("hh:mm A");      // "hh:mm a"
+convertMomentFormat("YYYY-MM-DD"); // "yyyy-MM-dd"
+convertMomentFormat("DD/MM/YYYY"); // "dd/MM/yyyy"
+convertMomentFormat("hh:mm A"); // "hh:mm a"
 ```
 
 ## Error Utilities
 
 ### Display errors (`error.ts`)
 
-| Export | Signature | Description |
-|--------|-----------|-------------|
-| `DisplayableError` | `class extends Error` | Normalized error with `details: string` and `originalError: unknown` properties |
-| `parseError` | `(errorToParse: unknown) => DisplayableError` | Parses any error type (Axios, plain object, string, JSON) into a `DisplayableError` |
+| Export             | Signature                                     | Description                                                                         |
+| ------------------ | --------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `DisplayableError` | `class extends Error`                         | Normalized error with `details: string` and `originalError: unknown` properties     |
+| `parseError`       | `(errorToParse: unknown) => DisplayableError` | Parses any error type (Axios, plain object, string, JSON) into a `DisplayableError` |
 
 ### Typed framework errors (`errorTypes.ts`)
 
-| Class | Code | Constructor |
-|-------|------|-------------|
-| `FrameworkError` | custom | `(message, code, context?)` -- base class with `toJSON()` |
-| `ValidationError` | `VALIDATION_ERROR` | `(message, context?)` |
-| `ServiceError` | `SERVICE_ERROR` | `(message, context?)` |
-| `InjectionError` | `INJECTION_ERROR` | `(serviceName, context?)` |
-| `RegistrationError` | `REGISTRATION_ERROR` | `(componentName, reason, context?)` |
-| `BladeError` | `BLADE_ERROR` | `(message, bladeId?, context?)` |
-| `ModuleLoadError` | `MODULE_LOAD_ERROR` | `(moduleId, reason, context?)` |
-
-| Function | Signature | Description |
-|----------|-----------|-------------|
-| `isFrameworkError` | `(error: unknown) => error is FrameworkError` | Type guard for `FrameworkError` instances |
-| `wrapError` | `(error: unknown, code?: string) => FrameworkError` | Wraps any error into a `FrameworkError`, preserving existing ones |
+| Class               | Code                 | Constructor                                               |
+| ------------------- | -------------------- | --------------------------------------------------------- |
+| `FrameworkError`    | custom               | `(message, code, context?)` -- base class with `toJSON()` |
+| `ValidationError`   | `VALIDATION_ERROR`   | `(message, context?)`                                     |
+| `ServiceError`      | `SERVICE_ERROR`      | `(message, context?)`                                     |
+| `InjectionError`    | `INJECTION_ERROR`    | `(serviceName, context?)`                                 |
+| `RegistrationError` | `REGISTRATION_ERROR` | `(componentName, reason, context?)`                       |
+| `BladeError`        | `BLADE_ERROR`        | `(message, bladeId?, context?)`                           |
+| `ModuleLoadError`   | `MODULE_LOAD_ERROR`  | `(moduleId, reason, context?)`                            |
+
+| Function           | Signature                                           | Description                                                       |
+| ------------------ | --------------------------------------------------- | ----------------------------------------------------------------- |
+| `isFrameworkError` | `(error: unknown) => error is FrameworkError`       | Type guard for `FrameworkError` instances                         |
+| `wrapError`        | `(error: unknown, code?: string) => FrameworkError` | Wraps any error into a `FrameworkError`, preserving existing ones |
 
 ### Error utility examples
 
@@ -103,12 +103,12 @@ try {
   await apiClient.save(data);
 } catch (err) {
   const parsed = parseError(err);
-  console.log(parsed.message);       // "Request failed with status 422"
-  console.log(parsed.details);       // "Validation error: name is required"
+  console.log(parsed.message); // "Request failed with status 422"
+  console.log(parsed.details); // "Validation error: name is required"
 }
 
 if (isFrameworkError(err)) {
-  console.log(err.code);    // e.g. "INJECTION_ERROR"
+  console.log(err.code); // e.g. "INJECTION_ERROR"
 }
 
 throw new InjectionError("WidgetService"); // "WidgetService is not provided. ..."
@@ -116,8 +116,8 @@ throw new InjectionError("WidgetService"); // "WidgetService is not provided. ..
 
 ## ID Generation
 
-| Function | Signature | Description |
-|----------|-----------|-------------|
+| Function     | Signature      | Description                                                                       |
+| ------------ | -------------- | --------------------------------------------------------------------------------- |
 | `generateId` | `() => string` | Returns a random 7-character alphanumeric string via `Math.random().toString(36)` |
 
 ```typescript
@@ -131,12 +131,12 @@ const widgetId = `widget-${generateId()}`; // e.g. "widget-m7p2x1b"
 
 Factory-based logger with level filtering. Default level: `debug` in dev, `warn` in production.
 
-| Export | Type | Description |
-|--------|------|-------------|
+| Export         | Type                           | Description                                                                                                |
+| -------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------- |
 | `createLogger` | `(context?: string) => Logger` | Creates a logger instance with `debug`, `info`, `warn`, `error`, `child`, `setLevel`, `setEnabled` methods |
-| `logger` | `Logger` | Default logger instance (no context prefix) |
-| `loggers` | `Record<string, Logger>` | Pre-configured loggers: `core`, `ui`, `shared`, `plugins`, `services`, `composables` |
-| `LogLevel` | `type` | `"debug" \| "info" \| "warn" \| "error" \| "none"` |
+| `logger`       | `Logger`                       | Default logger instance (no context prefix)                                                                |
+| `loggers`      | `Record<string, Logger>`       | Pre-configured loggers: `core`, `ui`, `shared`, `plugins`, `services`, `composables`                       |
+| `LogLevel`     | `type`                         | `"debug" \| "info" \| "warn" \| "error" \| "none"`                                                         |
 
 ### Logger examples
 
@@ -144,13 +144,13 @@ Factory-based logger with level filtering. Default level: `debug` in dev, `warn`
 import { createLogger, loggers } from "@vc-shell/framework";
 
 const log = createLogger("OrdersModule");
-log.info("Module initialized");              // [OrdersModule] Module initialized
-log.error("Failed to load orders", error);   // [OrdersModule] Failed to load orders Error: ...
+log.info("Module initialized"); // [OrdersModule] Module initialized
+log.error("Failed to load orders", error); // [OrdersModule] Failed to load orders Error: ...
 
 const subLog = log.child("DataSync");
-subLog.debug("Syncing 50 records");          // [OrdersModule:DataSync] Syncing 50 records
+subLog.debug("Syncing 50 records"); // [OrdersModule:DataSync] Syncing 50 records
 
-log.setLevel("error");  // Only errors will be logged
+log.setLevel("error"); // Only errors will be logged
 ```
 
 ## Tip: Use createLogger Instead of console.log
@@ -171,8 +171,8 @@ log.info("Order saved", { orderId: order.id });
 The `convertMomentFormat` function maps common Moment.js tokens to date-fns tokens, but does not cover every edge case. Uncommon tokens (like `X` for Unix timestamp) may need manual handling:
 
 ```typescript
-convertMomentFormat("YYYY-MM-DD");    // "yyyy-MM-dd" (correct)
-convertMomentFormat("X");             // May not convert as expected
+convertMomentFormat("YYYY-MM-DD"); // "yyyy-MM-dd" (correct)
+convertMomentFormat("X"); // May not convert as expected
 ```
 
 ## Related

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

@@ -9,6 +9,7 @@ The vc-shell framework uses Vue's provide/inject mechanism extensively to share
 All keys are defined in a single file (`framework/injection-keys.ts`) to avoid symbol duplication and ensure type safety. The app shell provides these values at the root during bootstrap; components and composables inject them using the corresponding key.
 
 This centralized approach has several advantages:
+
 - **Type safety**: `inject(MenuServiceKey)` returns `MenuService | undefined`, not `unknown`
 - **No symbol collisions**: each key is a unique `Symbol`, preventing accidental overwrites
 - **Testability**: services can be mocked by providing different values in test wrappers
@@ -18,76 +19,76 @@ 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                                  |
+| --------------------------- | -------------------------------------- | -------------------------------------------- |
+| `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                    |
 
 ### Notifications
 
-| Key | Type | Description |
-|-----|------|-------------|
+| Key                        | Type                                | Description                                 |
+| -------------------------- | ----------------------------------- | ------------------------------------------- |
 | `NotificationTemplatesKey` | `NotificationTemplateConstructor[]` | Registered notification template components |
-| `NotificationStoreKey` | `NotificationStore` | Shared notification store singleton |
+| `NotificationStoreKey`     | `NotificationStore`                 | Shared notification store singleton         |
 
 ### Services
 
-| Key | Type | Description |
-|-----|------|-------------|
-| `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 |
-| `AppBarMobileButtonsServiceKey` | `IAppBarMobileButtonsService` | Mobile app bar buttons |
-| `LanguageServiceKey` | `ILanguageService` | Localization service |
-| `ToolbarServiceKey` | `IToolbarService` | Blade toolbar actions |
-| `AiAgentServiceKey` | `IAiAgentService` | AI agent integration |
+| Key                             | Type                          | Description                    |
+| ------------------------------- | ----------------------------- | ------------------------------ |
+| `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           |
+| `AppBarMobileButtonsServiceKey` | `IAppBarMobileButtonsService` | Mobile app bar buttons         |
+| `LanguageServiceKey`            | `ILanguageService`            | Localization service           |
+| `ToolbarServiceKey`             | `IToolbarService`             | Blade toolbar actions          |
+| `AiAgentServiceKey`             | `IAiAgentService`             | AI agent integration           |
 
 ### Module System
 
-| Key | Type | Description |
-|-----|------|-------------|
-| `DynamicModulesKey` | `DynamicModuleRegistry \| undefined` | Registry of loaded dynamic modules (extensible via declaration merging) |
-| `ModulesReadyKey` | `Ref<boolean>` | Whether all modules have finished loading |
-| `ModulesLoadErrorKey` | `Ref<boolean>` | Whether all modules failed to load |
+| Key                   | Type                                 | Description                                                             |
+| --------------------- | ------------------------------------ | ----------------------------------------------------------------------- |
+| `DynamicModulesKey`   | `DynamicModuleRegistry \| undefined` | Registry of loaded dynamic modules (extensible via declaration merging) |
+| `ModulesReadyKey`     | `Ref<boolean>`                       | Whether all modules have finished loading                               |
+| `ModulesLoadErrorKey` | `Ref<boolean>`                       | Whether all modules failed to load                                      |
 
 ### UI State
 
-| Key | Type | Description |
-|-----|------|-------------|
-| `WidgetScopeKey` | `IWidgetScope` | Widget scope (provided by WidgetContainer for component-based widgets via `WidgetScope.vue`) |
-| `AppRootElementKey` | `Ref<HTMLElement \| undefined>` | App root element for scoped Teleport |
-| `EmbeddedModeKey` | `boolean` | Whether the app runs in embedded mode |
-| `ShellIndicatorsKey` | `ComputedRef<boolean>` | Unread indicator state for sidebar |
-| `CloseSettingsMenuKey` | `() => void` | Callback to close the settings menu |
+| Key                    | Type                            | Description                                                                                  |
+| ---------------------- | ------------------------------- | -------------------------------------------------------------------------------------------- |
+| `WidgetScopeKey`       | `IWidgetScope`                  | Widget scope (provided by WidgetContainer for component-based widgets via `WidgetScope.vue`) |
+| `AppRootElementKey`    | `Ref<HTMLElement \| undefined>` | App root element for scoped Teleport                                                         |
+| `EmbeddedModeKey`      | `boolean`                       | Whether the app runs in embedded mode                                                        |
+| `ShellIndicatorsKey`   | `ComputedRef<boolean>`          | Unread indicator state for sidebar                                                           |
+| `CloseSettingsMenuKey` | `() => void`                    | Callback to close the settings menu                                                          |
 
 ### Breakpoints
 
-| Key | Type | Description |
-|-----|------|-------------|
-| `IsMobileKey` | `Ref<boolean>` | Mobile breakpoint |
-| `IsDesktopKey` | `Ref<boolean>` | Desktop breakpoint |
-| `IsPhoneKey` | `Ref<boolean>` | Phone breakpoint |
-| `IsTabletKey` | `Ref<boolean>` | Tablet breakpoint |
-| `IsTouchKey` | `boolean` | Touch device detection |
+| Key            | Type           | Description            |
+| -------------- | -------------- | ---------------------- |
+| `IsMobileKey`  | `Ref<boolean>` | Mobile breakpoint      |
+| `IsDesktopKey` | `Ref<boolean>` | Desktop breakpoint     |
+| `IsPhoneKey`   | `Ref<boolean>` | Phone breakpoint       |
+| `IsTabletKey`  | `Ref<boolean>` | Tablet breakpoint      |
+| `IsTouchKey`   | `boolean`      | Touch device detection |
 
 ### 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                 |
+| ----------------------------- | --------------------------- |
+| `navigationViewLocation`      | `NavigationViewLocationKey` |
+| `BladeDescriptor`             | `BladeDescriptorKey`        |
+| `NotificationTemplatesSymbol` | `NotificationTemplatesKey`  |
+| `BLADE_BACK_BUTTON`           | `BladeBackButtonKey`        |
+| `TOOLBAR_SERVICE`             | `ToolbarServiceKey`         |
+| `EMBEDDED_MODE`               | `EmbeddedModeKey`           |
 
 ## Usage Examples
 

package/runtime/knowledge/docs/modules/assets-manager/assets-manager.docs.md

@@ -21,12 +21,12 @@ The module exports `AssetsManagerModule` (a Vue plugin) and the `AssetsManager`
 
 The blade reads its configuration from `options` via `useBlade<AssetsManagerOptions>()` (not props):
 
-| Option | Type | Description |
-|---|---|---|
-| `title` | `string?` | Custom blade title (defaults to i18n `ASSETS_MANAGER.TITLE`) |
-| `manager` | `UseAssetsManagerReturn` | The asset manager instance from `useAssetsManager()`. **Must be wrapped in `markRaw()`** |
-| `disabled` | `boolean?` | When true, hides upload/delete actions and disables reordering |
-| `hiddenFields` | `string[]?` | Fields to hide in the detail view |
+| Option         | Type                     | Description                                                                              |
+| -------------- | ------------------------ | ---------------------------------------------------------------------------------------- |
+| `title`        | `string?`                | Custom blade title (defaults to i18n `ASSETS_MANAGER.TITLE`)                             |
+| `manager`      | `UseAssetsManagerReturn` | The asset manager instance from `useAssetsManager()`. **Must be wrapped in `markRaw()`** |
+| `disabled`     | `boolean?`               | When true, hides upload/delete actions and disables reordering                           |
+| `hiddenFields` | `string[]?`              | Fields to hide in the detail view                                                        |
 
 > **Breaking change:** The old options (`assets`, `loading`, `assetsUploadHandler`, `assetsEditHandler`, `assetsRemoveHandler`) have been removed. Pass a single `manager` instance instead. See [migration guide #32](../../../migration/32-use-assets-manager.md).
 
@@ -71,9 +71,9 @@ openBlade({
 
 ## Toolbar
 
-| Button | Condition | Action |
-|---|---|---|
-| Add | `!disabled` | Opens file picker for upload |
+| Button | Condition                      | Action                                           |
+| ------ | ------------------------------ | ------------------------------------------------ |
+| Add    | `!disabled`                    | Opens file picker for upload                     |
 | Delete | `!disabled` and items selected | Calls `manager.removeMany()` with selected items |
 
 ## Tips

package/runtime/knowledge/docs/shell/_internal/popup/common/popup-common.docs.md

@@ -12,18 +12,18 @@ These components provide ready-to-use modal dialogs for common scenarios. Each v
 
 The foundation component. Wraps `VcPopup` and adds footer action buttons based on the `mode`.
 
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `title` | `string` | -- | Dialog title |
-| `variant` | `PopupVariant` | `"default"` | Visual style: `"default"`, `"warning"`, `"error"`, `"info"` |
-| `mode` | `"acknowledge" \| "confirm"` | `"acknowledge"` | `acknowledge` = single OK button; `confirm` = Confirm + Cancel |
-| `actionLabel` | `string` | `""` | Label for the single button in acknowledge mode |
-| `confirmLabel` | `string` | `""` | Label for the confirm button |
-| `cancelLabel` | `string` | `""` | Label for the cancel button |
-| `confirmAsText` | `boolean` | `false` | Render confirm button as text-only style |
-| `closable` | `boolean` | `true` | Show close (X) button in the header |
-| `isMobileFullscreen` | `boolean` | `true` | Expand to fullscreen on mobile |
-| `closeOnConfirm` | `boolean` | `false` | Auto-close the popup after confirm is emitted |
+| Prop                 | Type                         | Default         | Description                                                    |
+| -------------------- | ---------------------------- | --------------- | -------------------------------------------------------------- |
+| `title`              | `string`                     | --              | Dialog title                                                   |
+| `variant`            | `PopupVariant`               | `"default"`     | Visual style: `"default"`, `"warning"`, `"error"`, `"info"`    |
+| `mode`               | `"acknowledge" \| "confirm"` | `"acknowledge"` | `acknowledge` = single OK button; `confirm` = Confirm + Cancel |
+| `actionLabel`        | `string`                     | `""`            | Label for the single button in acknowledge mode                |
+| `confirmLabel`       | `string`                     | `""`            | Label for the confirm button                                   |
+| `cancelLabel`        | `string`                     | `""`            | Label for the cancel button                                    |
+| `confirmAsText`      | `boolean`                    | `false`         | Render confirm button as text-only style                       |
+| `closable`           | `boolean`                    | `true`          | Show close (X) button in the header                            |
+| `isMobileFullscreen` | `boolean`                    | `true`          | Expand to fullscreen on mobile                                 |
+| `closeOnConfirm`     | `boolean`                    | `false`         | Auto-close the popup after confirm is emitted                  |
 
 Events: `close`, `confirm`
 
@@ -34,17 +34,13 @@ Slots: `header`, `default` (content), `footer` (receives `{ close, confirm }`)
 A confirm dialog styled with the `warning` variant. Shows Confirm and Cancel buttons.
 
 ```vue
-<VcPopupWarning
-  title="Delete item?"
-  @close="onCancel"
-  @confirm="onDelete"
->
+<VcPopupWarning title="Delete item?" @close="onCancel" @confirm="onDelete">
   <p>This action cannot be undone.</p>
 </VcPopupWarning>
 ```
 
-| Prop | Type | Description |
-|---|---|---|
+| Prop    | Type     | Description  |
+| ------- | -------- | ------------ |
 | `title` | `string` | Dialog title |
 
 Events: `close`, `confirm`
@@ -55,16 +51,13 @@ Slots: `header`, `default`
 An acknowledge dialog styled with the `error` variant. Shows a single OK button.
 
 ```vue
-<VcPopupError
-  title="Operation Failed"
-  @close="dismiss"
->
+<VcPopupError title="Operation Failed" @close="dismiss">
   <p>Could not save changes. Please try again.</p>
 </VcPopupError>
 ```
 
-| Prop | Type | Description |
-|---|---|---|
+| Prop    | Type     | Description  |
+| ------- | -------- | ------------ |
 | `title` | `string` | Dialog title |
 
 Events: `close`
@@ -75,16 +68,13 @@ Slots: `header`, `default`
 An acknowledge dialog styled with the `info` variant. Shows a single OK button.
 
 ```vue
-<VcPopupInfo
-  title="Information"
-  @close="dismiss"
->
+<VcPopupInfo title="Information" @close="dismiss">
   <p>Your changes have been saved successfully.</p>
 </VcPopupInfo>
 ```
 
-| Prop | Type | Description |
-|---|---|---|
+| Prop    | Type     | Description  |
+| ------- | -------- | ------------ |
 | `title` | `string` | Dialog title |
 
 Events: `close`
@@ -95,12 +85,7 @@ Slots: `header`, `default`
 ### Confirmation before destructive action
 
 ```vue
-<VcPopupWarning
-  v-if="showDeleteConfirm"
-  title="Delete Order"
-  @confirm="deleteOrder"
-  @close="showDeleteConfirm = false"
->
+<VcPopupWarning v-if="showDeleteConfirm" title="Delete Order" @confirm="deleteOrder" @close="showDeleteConfirm = false">
   Are you sure you want to delete this order?
 </VcPopupWarning>
 ```
@@ -108,12 +93,7 @@ Slots: `header`, `default`
 ### Custom footer in VcPopupBase
 
 ```vue
-<VcPopupBase
-  variant="warning"
-  mode="confirm"
-  title="Custom Actions"
-  @close="onClose"
->
+<VcPopupBase variant="warning" mode="confirm" title="Custom Actions" @close="onClose">
   <template #footer="{ close, confirm }">
     <VcButton variant="danger" @click="confirm">Delete Forever</VcButton>
     <VcButton @click="close">Keep</VcButton>

package/runtime/knowledge/docs/shell/auth/ChangePasswordPage/change-password-page.docs.md

@@ -35,11 +35,11 @@ With custom branding:
 
 ## Key Props
 
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `forced` | `boolean` | `false` | Show expired-password info banner and adjusted title |
-| `logo` | `string` | - | Override logo image URL |
-| `background` | `string` | - | Custom background image URL |
+| Prop         | Type      | Default | Description                                          |
+| ------------ | --------- | ------- | ---------------------------------------------------- |
+| `forced`     | `boolean` | `false` | Show expired-password info banner and adjusted title |
+| `logo`       | `string`  | -       | Override logo image URL                              |
+| `background` | `string`  | -       | Custom background image URL                          |
 
 ## Recipe: Router Configuration with Forced Mode
 

package/runtime/knowledge/docs/shell/auth/ForgotPasswordPage/forgot-password-page.docs.md

@@ -31,11 +31,11 @@ With custom branding:
 
 ## Key Props
 
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `logo` | `string` | - | Override logo image URL |
-| `background` | `string` | - | Custom background image URL |
-| `composable` | `() => { forgotPassword }` | - | Custom composable providing `forgotPassword(args)` |
+| Prop         | Type                       | Default | Description                                        |
+| ------------ | -------------------------- | ------- | -------------------------------------------------- |
+| `logo`       | `string`                   | -       | Override logo image URL                            |
+| `background` | `string`                   | -       | Custom background image URL                        |
+| `composable` | `() => { forgotPassword }` | -       | Custom composable providing `forgotPassword(args)` |
 
 ## Recipe: Custom Reset Flow with a Different API
 

package/runtime/knowledge/docs/shell/auth/InvitePage/invite-page.docs.md

@@ -36,13 +36,13 @@ With custom branding:
 
 ## Key Props
 
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `userId` | `string` | **required** | Invited user's ID from the link |
-| `userName` | `string` | **required** | Invited user's email (shown as disabled field) |
-| `token` | `string` | **required** | Invitation token from the email link |
-| `logo` | `string` | `/assets/logo-white.svg` | Logo image URL |
-| `background` | `string` | `/assets/background.jpg` | Background image URL |
+| Prop         | Type     | Default                  | Description                                    |
+| ------------ | -------- | ------------------------ | ---------------------------------------------- |
+| `userId`     | `string` | **required**             | Invited user's ID from the link                |
+| `userName`   | `string` | **required**             | Invited user's email (shown as disabled field) |
+| `token`      | `string` | **required**             | Invitation token from the email link           |
+| `logo`       | `string` | `/assets/logo-white.svg` | Logo image URL                                 |
+| `background` | `string` | `/assets/background.jpg` | Background image URL                           |
 
 ## Recipe: Router Configuration
 
@@ -67,6 +67,7 @@ const routes = [
 ```
 
 The invitation email link typically looks like:
+
 ```
 https://your-app.com/invite?userId=abc123&userName=jane@example.com&token=xyz789...
 ```

package/runtime/knowledge/docs/shell/auth/LoginPage/login-page.docs.md

@@ -34,13 +34,13 @@ SSO-only mode:
 
 ## Key Props
 
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `logo` | `string` | - | Override logo image URL |
-| `background` | `string` | - | Custom background image URL |
-| `title` | `string` | i18n `LOGIN.TITLE` | Page heading text |
-| `subtitle` | `string` | i18n `LOGIN.SUBTITLE` | Page subheading text |
-| `ssoOnly` | `boolean` | `false` | Hide credentials form, show only SSO providers |
+| Prop         | Type      | Default               | Description                                    |
+| ------------ | --------- | --------------------- | ---------------------------------------------- |
+| `logo`       | `string`  | -                     | Override logo image URL                        |
+| `background` | `string`  | -                     | Custom background image URL                    |
+| `title`      | `string`  | i18n `LOGIN.TITLE`    | Page heading text                              |
+| `subtitle`   | `string`  | i18n `LOGIN.SUBTITLE` | Page subheading text                           |
+| `ssoOnly`    | `boolean` | `false`               | Hide credentials form, show only SSO providers |
 
 ## Recipe: Router Configuration