@vc-shell/framework 1.2.3 → 1.2.4-beta.2

package/dist/shared/components/blade-navigation/plugin-v2.d.ts

@@ -0,0 +1,39 @@
+import { Router } from "vue-router";
+import { App } from "vue";
+import * as components from "./components";
+import { BladeNavigationPlugin } from "./types";
+import type { IBladeRegistry } from "../../../core/composables/useBladeRegistry";
+declare module "@vue/runtime-core" {
+    interface GlobalComponents {
+        VcBladeNavigation: (typeof components)["VcBladeNavigation"];
+    }
+}
+export declare let bladeNavigationInstance: BladeNavigationPlugin;
+import type { IBladeStack, IBladeMessaging } from "./types";
+export declare let bladeStackInstance: IBladeStack | undefined;
+export declare let bladeMessagingInstance: IBladeMessaging | undefined;
+export declare let bladeRegistryInstance: IBladeRegistry | undefined;
+/**
+ * Reset all module-level singletons. For use in test teardown only.
+ * @internal
+ */
+export declare function _resetBladeNavigationSingletons(): void;
+/**
+ * New Blade Navigation Plugin (v2).
+ *
+ * Sets up:
+ * - BladeStack state machine (provided via BladeStackKey)
+ * - BladeMessaging for inter-blade communication (provided via BladeMessagingKey)
+ * - Auto catch-all route under the root route (safety net for blade URLs)
+ * - Router beforeEach guard for URL → blade stack restoration
+ *
+ * Vue Router serves as the URL sync layer only. BladeStack is the source of truth.
+ * Back/forward is handled natively by Vue Router — beforeEach fires on popstate
+ * and restores BladeStack from the URL.
+ */
+export declare const VcBladeNavigationComponent: {
+    install(app: App, args: {
+        router: Router;
+    }): void;
+};
+//# sourceMappingURL=plugin-v2.d.ts.map

package/dist/shared/components/blade-navigation/plugin-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-v2.d.ts","sourceRoot":"","sources":["../../../../shared/components/blade-navigation/plugin-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAoC,MAAM,SAAS,CAAC;AAMlF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAGjF,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAiB,gBAAgB;QAC/B,iBAAiB,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,mBAAmB,CAAC,CAAC;KAC7D;CACF;AAGD,eAAO,IAAI,uBAAuB,EAAE,qBAAqB,CAAC;AAM1D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC5D,eAAO,IAAI,kBAAkB,EAAE,WAAW,GAAG,SAAS,CAAC;AACvD,eAAO,IAAI,sBAAsB,EAAE,eAAe,GAAG,SAAS,CAAC;AAC/D,eAAO,IAAI,qBAAqB,EAAE,cAAc,GAAG,SAAS,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAItD;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B;iBACxB,GAAG,QAAQ;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;CAyF3C,CAAC"}

package/dist/shared/components/blade-navigation/types/index.d.ts

@@ -1,5 +1,5 @@
 import { Router } from "vue-router";
-import { AppContext, Component, ComponentOptionsBase, ComponentOptionsMixin, VNode, ComponentInternalInstance, VNodeTypes, Ref } from "vue";
+import { AppContext, Component, ComponentOptionsBase, ComponentOptionsMixin, VNode, ComponentInternalInstance, VNodeTypes, Ref, InjectionKey, ComputedRef } from "vue";
 import { ComponentPublicInstanceConstructor } from "../../../utilities/vueUtils";
 import { MenuItemConfig } from "../../../../core/types";
 import { Breadcrumbs } from "../../../../ui/types";
@@ -97,5 +97,119 @@ export interface BladeVNode extends VNode {
     } & Omit<VNode["props"], "onVnodeUnmounted" | "onVnodeMounted"> & CoreBladeComponentProps;
     type: VNodeTypes & BladeInstanceConstructor;
 }
+/**
+ * Plain data descriptor for a blade instance in the stack.
+ * Replaces BladeVNode — no VNode mutation, purely reactive data.
+ */
+export interface BladeDescriptor {
+    /** Unique per open blade instance (generated at open time) */
+    id: string;
+    /** Registered component name (e.g. "OrderDetails") from defineOptions */
+    name: string;
+    /** URL segment (e.g. "/order") from defineOptions — used for URL construction */
+    url?: string;
+    /** Entity ID — appears in URL path */
+    param?: string;
+    /** Small key-value pairs — serialized to URL query params */
+    query?: Record<string, string>;
+    /** Large context data — stored in history.state only, not in URL */
+    options?: Record<string, unknown>;
+    /** ID of the blade that opened this one (undefined for workspace) */
+    parentId?: string;
+    /** Whether this blade is currently visible */
+    visible: boolean;
+    /** Error state for this blade */
+    error?: unknown;
+    /** Blade title — populated at runtime from the component's defineExpose({ title }) */
+    title?: string;
+}
+/**
+ * Event object for opening a blade.
+ * Used by BladeStack.openBlade, openWorkspace, replaceCurrentBlade.
+ */
+export interface BladeOpenEvent {
+    /** Registered component name — resolved via BladeRegistry */
+    name: string;
+    /** Entity ID for the blade */
+    param?: string;
+    /** Small key-value pairs for URL query */
+    query?: Record<string, string>;
+    /** Large context data — stored in history.state only */
+    options?: Record<string, unknown>;
+    /** Called after the blade is opened */
+    onOpen?: () => void;
+    /** Called after the blade is closed */
+    onClose?: () => void;
+    /** If true, replaces current blade instead of opening a new one */
+    replaceCurrentBlade?: boolean;
+}
+/**
+ * Result of parsing a blade URL into its segments.
+ */
+export interface ParsedBladeUrl {
+    /** Workspace URL segment (e.g. "orders") */
+    workspaceUrl?: string;
+    /** Child blade URL segment (e.g. "order") */
+    bladeUrl?: string;
+    /** Entity ID from the URL path */
+    param?: string;
+}
+/**
+ * Public interface for the BladeStack state machine.
+ */
+export interface IBladeStack {
+    /** The workspace blade (first in stack) */
+    readonly workspace: ComputedRef<BladeDescriptor | undefined>;
+    /** All blades in the stack (including workspace at [0]) */
+    readonly blades: ComputedRef<readonly BladeDescriptor[]>;
+    /** The last visible blade */
+    readonly activeBlade: ComputedRef<BladeDescriptor | undefined>;
+    /** Switch to a different workspace — clears all existing blades */
+    openWorkspace(event: BladeOpenEvent): Promise<void>;
+    /** Open a new blade as a child of the active blade */
+    openBlade(event: BladeOpenEvent & {
+        parentId?: string;
+    }): Promise<void>;
+    /** Close a blade by ID. Returns true if close was prevented by a guard. */
+    closeBlade(bladeId: string): Promise<boolean>;
+    /** Replace the current active blade with a different one */
+    replaceCurrentBlade(event: BladeOpenEvent & {
+        parentId?: string;
+    }): Promise<void>;
+    /**
+     * Register a before-close guard for a blade.
+     *
+     * Guard semantics (NEW API): return `true` to PREVENT close, `false` to ALLOW.
+     *
+     * **Note**: The legacy `onBeforeClose` callback has INVERTED semantics:
+     * return `false` to prevent, `undefined`/`true` to allow.
+     * The adapter in `useBladeNavigationAdapter.ts` handles this inversion.
+     */
+    registerBeforeClose(bladeId: string, guard: () => Promise<boolean>): void;
+    /** Unregister a before-close guard */
+    unregisterBeforeClose(bladeId: string): void;
+    /** Set an error on a blade */
+    setBladeError(bladeId: string, error: unknown): void;
+    /** Clear a blade's error */
+    clearBladeError(bladeId: string): void;
+    /** Update a blade's title (called by VcBladeSlot when component exposes title) */
+    setBladeTitle(bladeId: string, title: string | undefined): void;
+    /** Restore stack from descriptors (used by HistoryManager — bypasses guards) */
+    _restoreStack(descriptors: BladeDescriptor[]): void;
+}
+/**
+ * Public interface for inter-blade messaging.
+ */
+export interface IBladeMessaging {
+    /** Expose methods to child blades */
+    exposeToChildren(bladeId: string, methods: Record<string, (...args: any[]) => any>): void;
+    /** Call a method exposed by the parent blade */
+    callParent<T = unknown>(callerBladeId: string, method: string, args?: unknown): Promise<T>;
+    /** Remove all exposed methods for a blade (cleanup on close) */
+    cleanup(bladeId: string): void;
+}
+export declare const BladeStackKey: InjectionKey<IBladeStack>;
+export declare const BladeMessagingKey: InjectionKey<IBladeMessaging>;
+export declare const BladeDescriptorKey: InjectionKey<ComputedRef<BladeDescriptor>>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/components/blade-navigation/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../shared/components/blade-navigation/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../shared/components/blade-navigation/types/index.ts"],"names":[],"mappings":"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"}

package/dist/shared/components/blade-navigation/utils/restoreFromUrl.d.ts

@@ -0,0 +1,20 @@
+import type { IBladeRegistry } from "../../../../core/composables/useBladeRegistry";
+import type { IBladeStack, ParsedBladeUrl } from "../types";
+/**
+ * Restore the blade stack from a parsed URL.
+ *
+ * Used on initial page load and when navigating via URL (not back/forward).
+ * Resolves URL segments to blade names via BladeRegistry, then opens
+ * workspace + child blade.
+ *
+ * Returns `true` if the URL contained segments for a non-routable blade
+ * that was skipped — the caller should clean up the URL to match the
+ * actual blade stack state.
+ *
+ * @param bladeStack - The BladeStack to populate
+ * @param bladeRegistry - Registry for resolving URLs → blade names
+ * @param parsed - Parsed URL segments
+ * @returns `true` if the URL needs cleanup (non-routable blade was skipped)
+ */
+export declare function restoreFromUrl(bladeStack: IBladeStack, bladeRegistry: IBladeRegistry, parsed: ParsedBladeUrl): Promise<boolean>;
+//# sourceMappingURL=restoreFromUrl.d.ts.map

package/dist/shared/components/blade-navigation/utils/restoreFromUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreFromUrl.d.ts","sourceRoot":"","sources":["../../../../../shared/components/blade-navigation/utils/restoreFromUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,WAAW,EACvB,aAAa,EAAE,cAAc,EAC7B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,OAAO,CAAC,CA4DlB"}

package/dist/shared/components/blade-navigation/utils/restoreFromUrl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=restoreFromUrl.test.d.ts.map

package/dist/shared/components/blade-navigation/utils/restoreFromUrl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreFromUrl.test.d.ts","sourceRoot":"","sources":["../../../../../shared/components/blade-navigation/utils/restoreFromUrl.test.ts"],"names":[],"mappings":""}

package/dist/shared/components/blade-navigation/utils/urlSync.d.ts

@@ -0,0 +1,54 @@
+import type { Router } from "vue-router";
+import type { BladeDescriptor, IBladeStack, ParsedBladeUrl } from "../types";
+/**
+ * Build a URL path from the current blade stack.
+ *
+ * URL format: /<tenantPrefix>/<workspaceUrl>/<bladeUrl>/<param>
+ * - tenantPrefix: optional seller/tenant ID
+ * - workspaceUrl: from workspace blade's `url` (e.g. "/orders" → "orders")
+ * - bladeUrl: from active child blade's `url` (e.g. "/order" → "order")
+ * - param: entity ID
+ *
+ * @param tenantPrefix - Tenant/seller ID segment (empty string if none)
+ * @param stack - Current blade stack
+ * @returns path string and merged query params
+ */
+export declare function buildUrlFromStack(tenantPrefix: string, stack: readonly BladeDescriptor[]): {
+    path: string;
+    query: Record<string, string>;
+};
+/**
+ * Parse a URL path into workspace, blade, and param segments.
+ *
+ * Handles both with and without tenant prefix:
+ *   /orders                    → { workspaceUrl: "orders" }
+ *   /orders/order/uuid         → { workspaceUrl: "orders", bladeUrl: "order", param: "uuid" }
+ *   /tenant-id/orders          → { workspaceUrl: "orders" } (after stripping tenant)
+ *   /tenant-id/orders/order/id → { workspaceUrl: "orders", bladeUrl: "order", param: "id" }
+ *
+ * @param hashPath - The path portion after the hash (e.g. "/orders/order/uuid")
+ * @param tenantPrefix - Optional tenant/seller ID to strip from the beginning
+ */
+export declare function parseBladeUrl(hashPath: string, tenantPrefix?: string): ParsedBladeUrl;
+/**
+ * Build query string from a record of key-value pairs.
+ * Returns empty string if no params.
+ */
+export declare function buildQueryString(query: Record<string, string>): string;
+/**
+ * Extract the tenant prefix from the current route params.
+ * Convention: first string param value (e.g. sellerId segment).
+ */
+export declare function getTenantPrefix(router: Router): string;
+/**
+ * Creates URL sync helpers bound to a specific router and blade stack.
+ * Eliminates duplication between VcBladeNavigation and useBladeNavigationAdapter.
+ *
+ * @param router - Vue Router instance
+ * @param bladeStack - BladeStack state machine
+ */
+export declare function createUrlSync(router: Router, bladeStack: IBladeStack): {
+    syncUrlPush: () => void;
+    syncUrlReplace: () => void;
+};
+//# sourceMappingURL=urlSync.d.ts.map

package/dist/shared/components/blade-navigation/utils/urlSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlSync.d.ts","sourceRoot":"","sources":["../../../../../shared/components/blade-navigation/utils/urlSync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE7E;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,eAAe,EAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA2CjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,CAiBrF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAItE;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW;uBAI3C,IAAI;0BAQD,IAAI;EAMhC"}

package/dist/shared/components/blade-navigation/utils/urlSync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=urlSync.test.d.ts.map

package/dist/shared/components/blade-navigation/utils/urlSync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlSync.test.d.ts","sourceRoot":"","sources":["../../../../../shared/components/blade-navigation/utils/urlSync.test.ts"],"names":[],"mappings":""}

package/dist/shared/components/draggable-dashboard/DraggableDashboard.vue.d.ts

@@ -1,8 +1,20 @@
-declare const _default: import("vue").DefineComponent<{}, {
+interface Props {
+    /** Show drag handle icons on widgets */
+    showDragHandles?: boolean;
+    /** Enable widget resizing */
+    resizable?: boolean;
+    /** Aria label for the dashboard container */
+    ariaLabel?: string;
+}
+declare const _default: import("vue").DefineComponent<Props, {
     rearrangeWidgets: () => void;
     recalculateLayout: () => void;
     saveLayout: () => void;
     useBuiltInPositions: () => boolean;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    ariaLabel: string;
+    resizable: boolean;
+    showDragHandles: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;
 //# sourceMappingURL=DraggableDashboard.vue.d.ts.map

package/dist/shared/components/draggable-dashboard/DraggableDashboard.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DraggableDashboard.vue.d.ts","sourceRoot":"","sources":["../../../../shared/components/draggable-dashboard/DraggableDashboard.vue"],"names":[],"mappings":";;;;;;AAgqBA,wBAMG"}
+{"version":3,"file":"DraggableDashboard.vue.d.ts","sourceRoot":"","sources":["../../../../shared/components/draggable-dashboard/DraggableDashboard.vue"],"names":[],"mappings":"AAyFA,UAAU,KAAK;IACb,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;4BAa4B,IAAI;6BAIH,IAAI;sBAIX,IAAI;+BAIK,OAAO;;eA1BzB,MAAM;eAFN,OAAO;qBAFD,OAAO;;AAkG3B,wBAQG"}

package/dist/shared/components/draggable-dashboard/GridstackDashboard.vue.d.ts

@@ -0,0 +1,21 @@
+import "gridstack/dist/gridstack.min.css";
+interface Props {
+    /** Show drag handle icons on widgets */
+    showDragHandles?: boolean;
+    /** Enable widget resizing */
+    resizable?: boolean;
+    /** Aria label for the dashboard container */
+    ariaLabel?: string;
+}
+declare const _default: import("vue").DefineComponent<Props, {
+    rearrangeWidgets: () => void;
+    recalculateLayout: () => void;
+    saveLayout: () => void;
+    useBuiltInPositions: () => boolean;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    ariaLabel: string;
+    resizable: boolean;
+    showDragHandles: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=GridstackDashboard.vue.d.ts.map

package/dist/shared/components/draggable-dashboard/GridstackDashboard.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridstackDashboard.vue.d.ts","sourceRoot":"","sources":["../../../../shared/components/draggable-dashboard/GridstackDashboard.vue"],"names":[],"mappings":"AA+UA,OAAO,kCAAkC,CAAC;AAG1C,UAAU,KAAK;IACb,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;4BAsE4B,IAAI;6BAIH,IAAI;;+BAIF,OAAO;;eA/EzB,MAAM;eAFN,OAAO;qBAFD,OAAO;;AAoP3B,wBAQG"}

package/dist/shared/components/draggable-dashboard/composables/useGridstack.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Gridstack Integration Composable
+ *
+ * Provides Vue 3 integration with Gridstack.js library.
+ * Handles initialization, event binding, and cleanup.
+ */
+import { type Ref, type ShallowRef } from "vue";
+import { GridStack, type GridStackOptions } from "gridstack";
+import type { IDashboardWidget, DashboardWidgetPosition } from "../types";
+/**
+ * Options for useGridstack composable
+ */
+export interface UseGridstackOptions {
+    /** Gridstack configuration options */
+    gridOptions?: Partial<GridStackOptions>;
+    /** Enable widget resizing */
+    resizable?: boolean;
+    /** Auto-save layout to localStorage */
+    autoSave?: boolean;
+    /** Callback when layout changes */
+    onLayoutChange?: (layout: Map<string, DashboardWidgetPosition>) => void;
+}
+/**
+ * Return type for useGridstack composable
+ */
+export interface UseGridstackReturn {
+    /** Reference to GridStack instance */
+    grid: ShallowRef<GridStack | null>;
+    /** Current layout map */
+    layout: Ref<Map<string, DashboardWidgetPosition>>;
+    /** Whether grid is initialized */
+    isInitialized: Ref<boolean>;
+    /** Initialize grid on element */
+    initGrid: (element: HTMLElement) => void;
+    /** Destroy grid instance */
+    destroyGrid: () => void;
+    /** Add a widget to the grid */
+    addWidget: (widget: IDashboardWidget) => void;
+    /** Remove a widget from the grid */
+    removeWidget: (widgetId: string) => void;
+    /** Update widget position */
+    updateWidgetPosition: (widgetId: string, position: DashboardWidgetPosition) => void;
+    /** Save current layout */
+    saveLayout: () => void;
+    /** Load layout from storage */
+    loadLayout: () => void;
+    /** Reset to built-in positions */
+    resetToDefaults: () => void;
+    /** Batch update mode (disable animations) */
+    batchUpdate: (fn: () => void) => void;
+}
+/**
+ * Vue 3 composable for Gridstack integration
+ */
+export declare function useGridstack(widgets: Ref<IDashboardWidget[]>, options?: UseGridstackOptions): UseGridstackReturn;
+//# sourceMappingURL=useGridstack.d.ts.map

package/dist/shared/components/draggable-dashboard/composables/useGridstack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGridstack.d.ts","sourceRoot":"","sources":["../../../../../shared/components/draggable-dashboard/composables/useGridstack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiD,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAsB,MAAM,WAAW,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AA8B1E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxC,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,IAAI,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACnC,yBAAyB;IACzB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAClD,kCAAkC;IAClC,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,+BAA+B;IAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC9C,oCAAoC;IACpC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,6BAA6B;IAC7B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACpF,0BAA0B;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,kCAAkC;IAClC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,6CAA6C;IAC7C,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,GAAG,CAAC,gBAAgB,EAAE,CAAC,EAChC,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAkSpB"}

package/dist/shared/components/draggable-dashboard/composables/useGridstackAdapter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Gridstack Type Adapter
+ *
+ * Converts between our IDashboardWidget types and Gridstack's GridStackWidget types.
+ * Handles localStorage format migration for backwards compatibility.
+ */
+import type { GridStackWidget, GridStackNode } from "gridstack";
+import type { IDashboardWidget, DashboardWidgetPosition, DashboardWidgetSize } from "../types";
+/**
+ * LocalStorage key for layout persistence
+ */
+export declare const LAYOUT_STORAGE_KEY = "vc-dashboard-layout";
+/**
+ * Converts our widget type to Gridstack widget format
+ */
+export declare function toGridstackWidget(widget: IDashboardWidget, position?: DashboardWidgetPosition): GridStackWidget;
+/**
+ * Extracts position from Gridstack node
+ */
+export declare function fromGridstackNode(node: GridStackNode): {
+    id: string;
+    position: DashboardWidgetPosition;
+    size: DashboardWidgetSize;
+};
+/**
+ * Converts Gridstack nodes array to our layout Map format
+ */
+export declare function gridstackNodesToLayoutMap(nodes: GridStackNode[]): Map<string, DashboardWidgetPosition>;
+/**
+ * Loads layout from localStorage with legacy format support
+ */
+export declare function loadLayoutFromStorage(): Map<string, DashboardWidgetPosition> | null;
+/**
+ * Saves layout to localStorage in Gridstack format
+ */
+export declare function saveLayoutToStorage(widgets: IDashboardWidget[], layout: Map<string, DashboardWidgetPosition>): void;
+/**
+ * Clears layout from localStorage
+ */
+export declare function clearLayoutStorage(): void;
+/**
+ * Merges saved layout with widget defaults
+ * Handles cases where widgets have been added/removed
+ * Auto-arranges widgets that don't have positions
+ */
+export declare function mergeLayoutWithWidgets(widgets: IDashboardWidget[], savedLayout: Map<string, DashboardWidgetPosition> | null): Map<string, DashboardWidgetPosition>;
+//# sourceMappingURL=useGridstackAdapter.d.ts.map

package/dist/shared/components/draggable-dashboard/composables/useGridstackAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGridstackAdapter.d.ts","sourceRoot":"","sources":["../../../../../shared/components/draggable-dashboard/composables/useGridstackAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AASxD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,uBAAuB,GACjC,eAAe,CAWjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,uBAAuB,CAAC;IAClC,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAYA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,EAAE,GACrB,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAatC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,IAAI,CA4BnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC3C,IAAI,CAiBN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC;AA2DD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,IAAI,GACvD,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CA4BtC"}

package/dist/shared/components/draggable-dashboard/index.d.ts

@@ -1,2 +1,13 @@
 export { default as DraggableDashboard } from "./DraggableDashboard.vue";
+export type { IDashboardWidget, DashboardWidgetPosition, DashboardWidgetSize, DashboardDragEvent, DashboardGridConfig, } from "./types";
+export { useGridstack } from "./composables/useGridstack";
+export type { UseGridstackOptions, UseGridstackReturn } from "./composables/useGridstack";
+import { toGridstackWidget as _toGridstackWidget, fromGridstackNode as _fromGridstackNode, loadLayoutFromStorage as _loadLayoutFromStorage, saveLayoutToStorage as _saveLayoutToStorage, mergeLayoutWithWidgets as _mergeLayoutWithWidgets, clearLayoutStorage as _clearLayoutStorage } from "./composables/useGridstackAdapter";
+export declare const toGridstackWidget: typeof _toGridstackWidget;
+export declare const fromGridstackNode: typeof _fromGridstackNode;
+export declare const loadLayoutFromStorage: typeof _loadLayoutFromStorage;
+export declare const saveLayoutToStorage: typeof _saveLayoutToStorage;
+export declare const mergeLayoutWithWidgets: typeof _mergeLayoutWithWidgets;
+export declare const clearLayoutStorage: typeof _clearLayoutStorage;
+export declare const LAYOUT_STORAGE_KEY = "vc-dashboard-layout";
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/components/draggable-dashboard/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../shared/components/draggable-dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../shared/components/draggable-dashboard/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGzE,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAG1F,OAAO,EACL,iBAAiB,IAAI,kBAAkB,EACvC,iBAAiB,IAAI,kBAAkB,EACvC,qBAAqB,IAAI,sBAAsB,EAC/C,mBAAmB,IAAI,oBAAoB,EAC3C,sBAAsB,IAAI,uBAAuB,EACjD,kBAAkB,IAAI,mBAAmB,EAE1C,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,iBAAiB,2BAAqB,CAAC;AACpD,eAAO,MAAM,iBAAiB,2BAAqB,CAAC;AACpD,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,eAAO,MAAM,mBAAmB,6BAAuB,CAAC;AACxD,eAAO,MAAM,sBAAsB,gCAA0B,CAAC;AAC9D,eAAO,MAAM,kBAAkB,4BAAsB,CAAC;AACtD,eAAO,MAAM,kBAAkB,wBAAsB,CAAC"}

package/dist/shared/components/generic-dropdown/generic-dropdown.vue.d.ts

@@ -1,5 +1,6 @@
 export interface Props<T> {
     opened?: boolean;
+    disabled?: boolean;
     items: T[];
     emptyText?: string;
     itemText?: (item: T) => string;
@@ -24,19 +25,22 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         item?: (args: {
             item: T;
             click: () => void;
-        }) => any;
-        empty?: () => any;
+        }) => unknown;
+        empty?: () => unknown;
         trigger?: (args: {
             isActive: boolean;
-        }) => any;
+            toggle: () => void;
+            open: () => void;
+            close: () => void;
+        }) => unknown;
         "items-container"?: (args: {
             items: T[];
             close: () => void;
-        }) => any;
+        }) => unknown;
     };
     emit: {
-        (e: "item-click", item: T): void;
-        (e: "update:opened", opened: boolean): void;
+        (event: "item-click", item: T): void;
+        (event: "update:opened", opened: boolean): void;
     };
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/dist/shared/components/generic-dropdown/generic-dropdown.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generic-dropdown.vue.d.ts","sourceRoot":"","sources":["../../../../shared/components/generic-dropdown/generic-dropdown.vue"],"names":[],"mappings":"AAkQA,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;IACvF,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAClC,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;yBAEgB,CAAC,EACjB,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;WAuNO,mBAAmB,CAAC;;;sKAAqC,OAAO,IAAsB,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI;WAClD,GAAG;;eAnMF,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,CAAC,CAAC;YAAC,KAAK,EAAE,MAAM,IAAI,CAAA;SAAE,KAAK,GAAG;gBAC5C,MAAM,GAAG;kBACP,CAAC,IAAI,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAA;SAAE,KAAK,GAAG;4BAC1B,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,IAAI,CAAA;SAAE,KAAK,GAAG;;;YAThE,YAAY,QAAQ,CAAC,GAAG,IAAI;YAC5B,eAAe,UAAU,OAAO,GAAG,IAAI;;EA4MzC,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AAlOzE,wBAkO4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
+{"version":3,"file":"generic-dropdown.vue.d.ts","sourceRoot":"","sources":["../../../../shared/components/generic-dropdown/generic-dropdown.vue"],"names":[],"mappings":"AA8HA,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;IACvF,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAClC,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;yBAEgB,CAAC,EACjB,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;WAiLO,mBAAmB,CAAC;;;sKAAqC,OAAO,IAAsB,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI;WAClD,GAAG;;eA5JF,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,CAAC,CAAC;YAAC,KAAK,EAAE,MAAM,IAAI,CAAA;SAAE,KAAK,OAAO;gBAChD,MAAM,OAAO;kBACX,CAAC,IAAI,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAC;YAAC,IAAI,EAAE,MAAM,IAAI,CAAC;YAAC,KAAK,EAAE,MAAM,IAAI,CAAA;SAAE,KAAK,OAAO;4BACvF,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,IAAI,CAAA;SAAE,KAAK,OAAO;;;gBAThE,YAAY,QAAQ,CAAC,GAAG,IAAI;gBAC5B,eAAe,UAAU,OAAO,GAAG,IAAI;;EAqK7C,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AA5LzE,wBA4L4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}

package/dist/shared/components/generic-dropdown/index.d.ts

@@ -1,2 +1,73 @@
-export { default as GenericDropdown } from "./generic-dropdown.vue";
+/**
+ * @deprecated Use `VcDropdown` from `framework/ui/components` instead.
+ * This wrapper is kept for backward compatibility and may be removed in a future release.
+ */
+export declare const GenericDropdown: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+    slots: {
+        item?: (args: {
+            item: T;
+            click: () => void;
+        }) => unknown;
+        empty?: () => unknown;
+        trigger?: (args: {
+            isActive: boolean;
+            toggle: () => void;
+            open: () => void;
+            close: () => void;
+        }) => unknown;
+        "items-container"?: (args: {
+            items: T[];
+            close: () => void;
+        }) => unknown;
+    };
+    attrs: any;
+    emit: {
+        (event: "item-click", item: T): void;
+        (event: "update:opened", opened: boolean): void;
+    };
+}, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: {
+        readonly "onItem-click"?: ((item: T) => any) | undefined;
+        readonly "onUpdate:opened"?: ((opened: boolean) => any) | undefined;
+        opened?: boolean | undefined;
+        disabled?: boolean | undefined;
+        items: T[];
+        emptyText?: string | undefined;
+        itemText?: ((item: T) => string) | undefined;
+        isItemActive?: ((item: T) => boolean) | undefined;
+        floating?: boolean | undefined;
+        placement?: "bottom" | "bottom-end" | "bottom-start" | "top" | "top-end" | "top-start" | undefined;
+        variant?: "default" | "secondary" | undefined;
+        offset?: {
+            mainAxis?: number;
+            crossAxis?: number;
+        } | undefined;
+        maxHeight?: number | string | undefined;
+    } & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {
+        item?: (args: {
+            item: T;
+            click: () => void;
+        }) => unknown;
+        empty?: () => unknown;
+        trigger?: (args: {
+            isActive: boolean;
+            toggle: () => void;
+            open: () => void;
+            close: () => void;
+        }) => unknown;
+        "items-container"?: (args: {
+            items: T[];
+            close: () => void;
+        }) => unknown;
+    };
+    emit: {
+        (event: "item-click", item: T): void;
+        (event: "update:opened", opened: boolean): void;
+    };
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/components/generic-dropdown/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../shared/components/generic-dropdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../shared/components/generic-dropdown/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACqzF,CAAC;qBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAAwvM,CAAC;CAD5iS,CAAC"}

package/dist/shared/components/index.d.ts

@@ -8,11 +8,17 @@ export * from "./language-selector";
 export * from "./user-dropdown-button";
 export * from "./notification-dropdown";
 export * from "./notification-template";
-export * from "./sidebar";
+/**
+ * @deprecated Use `VcSidebar` from `framework/ui/components` instead.
+ */
+export { Sidebar } from "./sidebar";
 export * from "./theme-selector";
 export * from "./sign-in";
 export * from "./settings-menu-item";
-export * from "./generic-dropdown";
+/**
+ * @deprecated Use `VcDropdown` from `framework/ui/components` instead.
+ */
+export { GenericDropdown } from "./generic-dropdown";
 export * from "./draggable-dashboard";
 export * from "./dashboard-widget-card";
 export * from "./multilanguage-selector";