@vc-shell/framework 1.2.2 → 1.2.3-beta.0

package/dist/core/composables/useUser/index.d.ts

@@ -1,6 +1,12 @@
 import { ComputedRef } from "vue";
 import { UserDetail, SecurityResult, IdentityResult, LoginType, SignInResult } from "./../../api/platform";
 import { RequestPasswordResult } from "./../../types";
+export interface TokenData {
+    token: string | null;
+    access_token: string | null;
+    refresh_token: string | null;
+    expires_at: number | null;
+}
 export interface IUserInternalAPI {
     user: ComputedRef<UserDetail | undefined>;
     loading: ComputedRef<boolean>;
@@ -17,6 +23,7 @@ export interface IUserInternalAPI {
     requestPasswordReset: (loginOrEmail: string) => Promise<RequestPasswordResult>;
     changeUserPassword: (oldPassword: string, newPassword: string) => Promise<SecurityResult | undefined>;
     getLoginType: () => Promise<LoginType[]>;
+    getAccessToken: () => Promise<string | null>;
     isAuthenticated: ComputedRef<boolean>;
 }
 export interface IAppUserAPI {
@@ -26,6 +33,7 @@ export interface IAppUserAPI {
     isAdministrator: ComputedRef<boolean | undefined>;
     loadUser: () => Promise<UserDetail>;
     signOut: () => Promise<void>;
+    getAccessToken: () => Promise<string | null>;
 }
 export declare function _createInternalUserLogic(): IUserInternalAPI;
 export declare const useUser: () => IAppUserAPI;

package/dist/core/composables/useUser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useUser/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,WAAW,EAAE,MAAM,KAAK,CAAC;AACtD,OAAO,EACL,UAAU,EAGV,cAAc,EAEd,cAAc,EAEd,SAAS,EAET,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAKtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC1C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,eAAe,EAAE,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC5G,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAChE,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACnG,oBAAoB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/E,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACtG,YAAY,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACzC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC1C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,eAAe,EAAE,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAID,wBAAgB,wBAAwB,IAAI,gBAAgB,CAwJ3D;AAED,eAAO,MAAM,OAAO,QAA8B,WAUhD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useUser/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,WAAW,EAAE,MAAM,KAAK,CAAC;AACtD,OAAO,EACL,UAAU,EAGV,cAAc,EAEd,cAAc,EAEd,SAAS,EAET,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAKtD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAOD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC1C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,eAAe,EAAE,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC5G,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAChE,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACnG,oBAAoB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/E,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACtG,YAAY,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACzC,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC1C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,eAAe,EAAE,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9C;AA+ED,wBAAgB,wBAAwB,IAAI,gBAAgB,CAuO3D;AAED,eAAO,MAAM,OAAO,QAA8B,WAWhD,CAAC"}

package/dist/core/composables/useWidgets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useWidgets/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,cAAc,EACd,cAAc,EACd,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAGzC,wBAAgB,oBAAoB,IAAI,cAAc,CAIrD;AAED,wBAAgB,UAAU,IAAI,cAAc,CAO3C;AAED,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useWidgets/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,cAAc,EACd,cAAc,EACd,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAMzC,wBAAgB,oBAAoB,IAAI,cAAc,CAIrD;AAED,wBAAgB,UAAU,IAAI,cAAc,CAO3C;AAED,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/core/constants/defaults.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Component Default Values for VC-Shell Framework
+ * Centralized storage for default prop values across components
+ */
+export declare const COMPONENT_DEFAULTS: {
+    readonly input: {
+        readonly maxlength: 1024;
+        readonly debounce: 0;
+        readonly type: "text";
+        readonly autocomplete: "off";
+    };
+    readonly select: {
+        readonly debounce: 500;
+        readonly pageSize: 20;
+        readonly searchable: true;
+        readonly clearable: true;
+    };
+    readonly table: {
+        readonly pageSize: 20;
+        readonly pageSizes: readonly number[];
+        readonly selectable: false;
+        readonly multiselect: false;
+        readonly stickyHeader: true;
+    };
+    readonly pagination: {
+        readonly pageSize: 20;
+        readonly visiblePages: 5;
+    };
+    readonly textarea: {
+        readonly rows: 3;
+        readonly maxlength: 4096;
+    };
+    readonly editor: {
+        readonly minHeight: 200;
+        readonly maxHeight: 500;
+    };
+    readonly tooltip: {
+        readonly delay: 300;
+        readonly placement: "top";
+    };
+    readonly modal: {
+        readonly closeOnEscape: true;
+        readonly closeOnOverlayClick: true;
+    };
+    readonly notification: {
+        readonly duration: 5000;
+        readonly position: "top-right";
+    };
+    readonly dashboard: {
+        readonly columns: 12;
+        readonly rowHeight: 80;
+        readonly gap: 20;
+    };
+};
+/**
+ * Type for accessing component defaults
+ */
+export type ComponentDefaults = typeof COMPONENT_DEFAULTS;
+/**
+ * Helper to get defaults for a specific component
+ */
+export declare function getComponentDefaults<K extends keyof ComponentDefaults>(componentName: K): ComponentDefaults[K];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/core/constants/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../core/constants/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;4BAiBK,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC3C,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC;AAE1D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,aAAa,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAE9G"}

package/dist/core/constants/index.d.ts

@@ -1,3 +1,5 @@
 export declare const FALLBACK_BLADE_ID = "fallback-blade-id";
 export * from "./locale";
+export * from "./ui";
+export * from "./defaults";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/constants/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/constants/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC"}

package/dist/core/constants/ui.d.ts

@@ -0,0 +1,50 @@
+/**
+ * UI Constants for VC-Shell Framework
+ * Centralized storage for magic numbers and UI-related constants
+ */
+export declare const UI_CONSTANTS: {
+    readonly GRID_COLUMNS: 12;
+    readonly CELL_HEIGHT: 80;
+    readonly WIDGET_GAP: 20;
+    readonly DEBOUNCE_DEFAULT_MS: 500;
+    readonly HOVER_DELAY_MS: 200;
+    readonly TOOLTIP_DELAY_MS: 300;
+    readonly RESIZE_DEBOUNCE_MS: 100;
+    readonly ANIMATION_DURATION_MS: 200;
+    readonly TRANSITION_DURATION_MS: 150;
+    readonly DRAG_THRESHOLD_PX: 3;
+    readonly MAX_COLLISION_ITERATIONS: 50;
+    readonly MIN_COLUMN_WIDTH_PX: 15;
+    readonly OVERFLOW_THRESHOLD: 100;
+    readonly Z_INDEX: {
+        readonly DROPDOWN: 100;
+        readonly TOOLTIP: 9999;
+        readonly POPUP: 10000;
+        readonly MODAL: 10001;
+        readonly DRAG: 1000;
+        readonly SIDEBAR: 50;
+        readonly HEADER: 40;
+    };
+    readonly PAGINATION_VISIBLE_PAGES: 5;
+    readonly PAGINATION_EDGE_PAGES: 3;
+    readonly TABLE_ROW_HEIGHT: 48;
+    readonly TABLE_HEADER_HEIGHT: 56;
+    readonly DEFAULT_MAXLENGTH: 1024;
+    readonly DEFAULT_TEXTAREA_ROWS: 3;
+    readonly MENU_COLLAPSED_WIDTH: 76;
+    readonly MENU_EXPANDED_WIDTH: 246;
+    readonly MENU_ITEM_HEIGHT: 38;
+    readonly BREAKPOINTS: {
+        readonly XS: 0;
+        readonly SM: 576;
+        readonly MD: 768;
+        readonly LG: 992;
+        readonly XL: 1200;
+        readonly XXL: 1400;
+    };
+};
+/**
+ * Type for accessing UI constants values
+ */
+export type UIConstants = typeof UI_CONSTANTS;
+//# sourceMappingURL=ui.d.ts.map

package/dist/core/constants/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../core/constants/ui.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDf,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC"}

package/dist/core/interceptors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/interceptors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIpC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,wFAiElD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/interceptors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAOpC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,wFAiElD"}

package/dist/core/plugins/ai-agent/components/VcAiAgentPanel.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=VcAiAgentPanel.vue.d.ts.map

package/dist/core/plugins/ai-agent/components/VcAiAgentPanel.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VcAiAgentPanel.vue.d.ts","sourceRoot":"","sources":["../../../../../core/plugins/ai-agent/components/VcAiAgentPanel.vue"],"names":[],"mappings":";AAoRA,wBAKG"}

package/dist/core/plugins/ai-agent/components/_internal/VcAiAgentHeader.vue.d.ts

@@ -0,0 +1,15 @@
+type __VLS_Props = {
+    title?: string;
+    isExpanded: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    close: () => any;
+    expand: () => any;
+    collapse: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onExpand?: (() => any) | undefined;
+    onCollapse?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=VcAiAgentHeader.vue.d.ts.map

package/dist/core/plugins/ai-agent/components/_internal/VcAiAgentHeader.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VcAiAgentHeader.vue.d.ts","sourceRoot":"","sources":["../../../../../../core/plugins/ai-agent/components/_internal/VcAiAgentHeader.vue"],"names":[],"mappings":"AA0LA,KAAK,WAAW,GAAG;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;;;;;;;;;;AAgMF,wBAOG"}

package/dist/core/plugins/ai-agent/components/_internal/VcAiAgentIframe.vue.d.ts

@@ -0,0 +1,10 @@
+type __VLS_Props = {
+    url: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "iframe-ready": (iframe: HTMLIFrameElement) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onIframe-ready"?: ((iframe: HTMLIFrameElement) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=VcAiAgentIframe.vue.d.ts.map

package/dist/core/plugins/ai-agent/components/_internal/VcAiAgentIframe.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VcAiAgentIframe.vue.d.ts","sourceRoot":"","sources":["../../../../../../core/plugins/ai-agent/components/_internal/VcAiAgentIframe.vue"],"names":[],"mappings":"AAkFA,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;;;;;;AAwGF,wBAOG"}

package/dist/core/plugins/ai-agent/components/index.d.ts

@@ -0,0 +1,2 @@
+export { default as VcAiAgentPanel } from "./VcAiAgentPanel.vue";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugins/ai-agent/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../core/plugins/ai-agent/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/plugins/ai-agent/composables/index.d.ts

@@ -0,0 +1,4 @@
+export { useAiAgent, provideAiAgentService, createAiAgentToolbarButton } from "./useAiAgent";
+export type { UseAiAgentReturn, ProvideAiAgentServiceOptions } from "./useAiAgent";
+export { useAiAgentContext, clearPreviewState } from "./useAiAgentContext";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugins/ai-agent/composables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../core/plugins/ai-agent/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC7F,YAAY,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/plugins/ai-agent/composables/useAiAgent.d.ts

@@ -0,0 +1,95 @@
+import { type IAiAgentServiceInternal } from "../services/ai-agent-service";
+import type { IAiAgentService, IAiAgentConfig, IAiAgentMessage } from "../types";
+/**
+ * Options for providing the AI agent service
+ */
+export interface ProvideAiAgentServiceOptions {
+    /** Initial configuration for the AI agent */
+    config?: Partial<IAiAgentConfig>;
+    /**
+     * Whether to add the AI button to all blade toolbars automatically.
+     * Default: true
+     */
+    addGlobalToolbarButton?: boolean;
+}
+/**
+ * Provides the AI agent service at the current component level.
+ * Should be called once at the app level (in VcApp or plugin install).
+ *
+ * @param options - Configuration options
+ */
+export declare function provideAiAgentService(options?: ProvideAiAgentServiceOptions): IAiAgentServiceInternal;
+/**
+ * Return type for useAiAgent composable
+ */
+export interface UseAiAgentReturn {
+    /** Current panel state ("closed" | "open" | "expanded") */
+    panelState: IAiAgentService["panelState"];
+    /** Panel configuration */
+    config: IAiAgentService["config"];
+    /** Current context (reactive) */
+    context: IAiAgentService["context"];
+    /** Whether panel is open (not closed) */
+    isOpen: IAiAgentService["isOpen"];
+    /** Whether panel is in expanded state */
+    isExpanded: IAiAgentService["isExpanded"];
+    /** Total count of items in current context */
+    totalItemsCount: IAiAgentService["totalItemsCount"];
+    /** Open the AI panel */
+    openPanel: () => void;
+    /** Close the AI panel */
+    closePanel: () => void;
+    /** Toggle panel open/close */
+    togglePanel: () => void;
+    /** Expand the panel to larger width */
+    expandPanel: () => void;
+    /** Collapse panel to normal width */
+    collapsePanel: () => void;
+    /** Update configuration */
+    setConfig: (config: Partial<IAiAgentConfig>) => void;
+    /** Send message to AI agent iframe */
+    sendMessage: IAiAgentService["sendMessage"];
+    /** Register message handler, returns unsubscribe function */
+    onMessage: (handler: (event: IAiAgentMessage) => void) => () => void;
+}
+/**
+ * Composable for interacting with the AI agent panel.
+ *
+ * @example
+ * ```typescript
+ * const { togglePanel, isOpen, onMessage } = useAiAgent();
+ *
+ * // Toggle AI panel
+ * const handleAiClick = () => togglePanel();
+ *
+ * // Listen for messages from AI agent
+ * onMessage((message) => {
+ *   if (message.type === 'PREVIEW_CHANGES') {
+ *     // Handle preview changes
+ *   }
+ * });
+ * ```
+ */
+export declare function useAiAgent(): UseAiAgentReturn;
+/**
+ * Creates a toolbar button configuration for opening the AI agent.
+ * Can be used directly in blade toolbar definitions.
+ *
+ * @example
+ * ```typescript
+ * const bladeToolbar = [
+ *   createAiAgentToolbarButton(),
+ *   // ... other toolbar items
+ * ];
+ * ```
+ */
+export declare function createAiAgentToolbarButton(options?: {
+    title?: string;
+    icon?: string;
+}): {
+    id: string;
+    icon: string;
+    title: string;
+    clickHandler: () => void;
+};
+//# sourceMappingURL=useAiAgent.d.ts.map

package/dist/core/plugins/ai-agent/composables/useAiAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiAgent.d.ts","sourceRoot":"","sources":["../../../../../core/plugins/ai-agent/composables/useAiAgent.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAElG,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EAEhB,MAAM,UAAU,CAAC;AASlB;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,4BAA4B,GAAG,uBAAuB,CA8ErG;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC1C,0BAA0B;IAC1B,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,iCAAiC;IACjC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC,yCAAyC;IACzC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,yCAAyC;IACzC,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC1C,8CAA8C;IAC9C,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACpD,wBAAwB;IACxB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,yBAAyB;IACzB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,uCAAuC;IACvC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,qCAAqC;IACrC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,2BAA2B;IAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACrD,sCAAsC;IACtC,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC5C,6DAA6D;IAC7D,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CA8B7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;EAkBrF"}

package/dist/core/plugins/ai-agent/composables/useAiAgentContext.d.ts

@@ -0,0 +1,55 @@
+import type { UseAiAgentContextOptions, UseAiAgentContextReturn } from "../types";
+/**
+ * Composable for binding blade data to AI agent context.
+ *
+ * This composable automatically:
+ * - Sends data updates to the AI agent when dataRef changes
+ * - Normalizes single objects to arrays for the AI agent
+ * - Handles PREVIEW_CHANGES messages to update form data
+ * - Provides preview state for visual feedback
+ *
+ * @example List blade (array of selected items)
+ * ```typescript
+ * const { selectedItems } = useTableSelection<Offer>();
+ *
+ * useAiAgentContext({ dataRef: selectedItems });
+ * ```
+ *
+ * @example Details blade (single object - automatically wrapped in array)
+ * ```typescript
+ * const offer = ref<Offer>({});
+ *
+ * // Just pass the ref directly - no need to wrap in array!
+ * const { previewState } = useAiAgentContext({ dataRef: offer });
+ *
+ * // Use previewState.isActive to show preview indicator
+ * ```
+ *
+ * @example With custom suggestions
+ * ```typescript
+ * useAiAgentContext({
+ *   dataRef: offer,
+ *   suggestions: [
+ *     {
+ *       id: "translate",
+ *       title: "Translate description",
+ *       icon: "translation",
+ *       iconColor: "#FF4A4A",
+ *       prompt: "Translate the offer description to English"
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+export declare function useAiAgentContext<T extends {
+    id: string;
+    objectType: string;
+    name: string;
+    [key: string]: unknown;
+}>(options: UseAiAgentContextOptions<T>): UseAiAgentContextReturn;
+/**
+ * Clears the preview state manually.
+ * Useful when user saves or discards changes.
+ */
+export declare function clearPreviewState(previewState: UseAiAgentContextReturn["previewState"]): void;
+//# sourceMappingURL=useAiAgentContext.d.ts.map

package/dist/core/plugins/ai-agent/composables/useAiAgentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiAgentContext.d.ts","sourceRoot":"","sources":["../../../../../core/plugins/ai-agent/composables/useAiAgentContext.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,wBAAwB,EACxB,uBAAuB,EAGxB,MAAM,UAAU,CAAC;AAgFlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAClH,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACnC,uBAAuB,CAuIzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,uBAAuB,CAAC,cAAc,CAAC,GAAG,IAAI,CAI7F"}

package/dist/core/plugins/ai-agent/constants.d.ts

@@ -0,0 +1,47 @@
+import type { IAiAgentConfig, ISuggestion } from "./types";
+/**
+ * Default configuration for AI agent panel
+ */
+export declare const DEFAULT_AI_AGENT_CONFIG: IAiAgentConfig;
+/**
+ * Environment variable name for AI agent URL
+ */
+export declare const AI_AGENT_URL_ENV_KEY = "APP_AI_AGENT_URL";
+/**
+ * Message types for Shell -> Chat communication
+ */
+export declare const SHELL_TO_CHAT_MESSAGE_TYPES: {
+    readonly INIT_CONTEXT: "INIT_CONTEXT";
+    readonly UPDATE_CONTEXT: "UPDATE_CONTEXT";
+};
+/**
+ * Message types for Chat -> Shell communication
+ */
+export declare const CHAT_TO_SHELL_MESSAGE_TYPES: {
+    readonly CHAT_READY: "CHAT_READY";
+    readonly NAVIGATE_TO_APP: "NAVIGATE_TO_APP";
+    readonly EXPAND_IN_CHAT: "EXPAND_IN_CHAT";
+    readonly RELOAD_BLADE: "RELOAD_BLADE";
+    readonly PREVIEW_CHANGES: "PREVIEW_CHANGES";
+    readonly APPLY_CHANGES: "APPLY_CHANGES";
+    readonly DOWNLOAD_FILE: "DOWNLOAD_FILE";
+    readonly SHOW_MORE: "SHOW_MORE";
+    readonly CHAT_ERROR: "CHAT_ERROR";
+};
+/**
+ * Default suggestions when no custom suggestions provided
+ */
+export declare const DEFAULT_SUGGESTIONS: ISuggestion[];
+/**
+ * Default toolbar button ID for AI agent
+ */
+export declare const AI_AGENT_TOOLBAR_BUTTON_ID = "ai-agent-toggle";
+/**
+ * Default toolbar button icon
+ */
+export declare const AI_AGENT_TOOLBAR_BUTTON_ICON = "lucide-sparkles";
+/**
+ * Default toolbar button title
+ */
+export declare const AI_AGENT_TOOLBAR_BUTTON_TITLE = "AI Assistant";
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/plugins/ai-agent/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../core/plugins/ai-agent/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAMrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;CAU9B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,EA6B5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,oBAAoB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,4BAA4B,oBAAoB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,6BAA6B,iBAAiB,CAAC"}

package/dist/core/plugins/ai-agent/index.d.ts

@@ -0,0 +1,48 @@
+import type { App } from "vue";
+import type { IAiAgentConfig } from "./types";
+/**
+ * Options for the AI Agent Plugin
+ */
+export interface AiAgentPluginOptions {
+    /**
+     * AI Agent configuration.
+     * URL can also be set via APP_AI_AGENT_URL environment variable.
+     */
+    config?: Partial<IAiAgentConfig>;
+    /**
+     * Whether to add the AI button to all blade toolbars automatically.
+     * Default: true
+     */
+    addGlobalToolbarButton?: boolean;
+}
+/**
+ * Vue plugin for AI Agent integration.
+ *
+ * @example
+ * ```typescript
+ * import { createApp } from "vue";
+ * import { aiAgentPlugin } from "@vc-shell/framework";
+ *
+ * const app = createApp(App);
+ *
+ * // Install with options
+ * app.use(aiAgentPlugin, {
+ *   config: {
+ *     title: "AI Assistant",
+ *     width: 400,
+ *   },
+ *   addGlobalToolbarButton: true,
+ * });
+ * ```
+ */
+export declare const aiAgentPlugin: {
+    install(app: App, options?: AiAgentPluginOptions): void;
+};
+export * from "./types";
+export * from "./constants";
+export { useAiAgent, provideAiAgentService, createAiAgentToolbarButton } from "./composables/useAiAgent";
+export type { UseAiAgentReturn, ProvideAiAgentServiceOptions } from "./composables/useAiAgent";
+export { useAiAgentContext, clearPreviewState } from "./composables/useAiAgentContext";
+export { VcAiAgentPanel } from "./components";
+export type { IAiAgentServiceInternal, CreateAiAgentServiceOptions } from "./services/ai-agent-service";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugins/ai-agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/plugins/ai-agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,aAAa;iBACX,GAAG,YAAW,oBAAoB;CA6BhD,CAAC;AAGF,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACzG,YAAY,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE/F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGvF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,YAAY,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/core/plugins/ai-agent/services/ai-agent-service.d.ts

@@ -0,0 +1,45 @@
+import { type ShallowRef } from "vue";
+import { IAiAgentService, IAiAgentConfig, AiAgentContextType, IAiAgentBladeContext, IAiAgentUserContext, IPreviewChangesPayload, ISuggestion } from "../types";
+/**
+ * Options for creating the AI agent service
+ */
+export interface CreateAiAgentServiceOptions {
+    /** Function to get current user information */
+    userGetter: () => IAiAgentUserContext | undefined;
+    /** Function to get current blade context */
+    bladeGetter: () => IAiAgentBladeContext | null;
+    /** Function to get user locale */
+    localeGetter: () => string;
+    /** Function to get access token (handles automatic refresh) */
+    tokenGetter?: () => Promise<string | null>;
+    /** Function to navigate to blade */
+    navigateToBlade?: (bladeName: string, param?: string, options?: Record<string, unknown>) => void;
+    /** Function to reload current blade */
+    reloadBlade?: () => void;
+    /** Initial configuration */
+    initialConfig?: Partial<IAiAgentConfig>;
+}
+/**
+ * Extended AI Agent Service with internal methods for component use
+ */
+export interface IAiAgentServiceInternal extends IAiAgentService {
+    /** Reference to the iframe element (set by component) */
+    iframeRef: ShallowRef<HTMLIFrameElement | null>;
+    /** Set the iframe reference (called by component) */
+    _setIframeRef: (iframe: HTMLIFrameElement | null) => void;
+    /** Handle incoming postMessage events (called by component) */
+    _handleIncomingMessage: (event: MessageEvent) => void;
+    /** Start listening for postMessage events */
+    _startListening: () => void;
+    /** Stop listening for postMessage events */
+    _stopListening: () => void;
+    /** Update context data for a blade (called by useAiAgentContext) */
+    _setContextData: (items: Record<string, unknown>[], type: AiAgentContextType, suggestions?: ISuggestion[], bladeId?: string) => void;
+    /** Register preview changes handler */
+    _onPreviewChanges: (handler: (payload: IPreviewChangesPayload) => void) => () => void;
+}
+/**
+ * Creates an AI agent service for managing the AI panel state and communication.
+ */
+export declare function createAiAgentService(options: CreateAiAgentServiceOptions): IAiAgentServiceInternal;
+//# sourceMappingURL=ai-agent-service.d.ts.map

package/dist/core/plugins/ai-agent/services/ai-agent-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agent-service.d.ts","sourceRoot":"","sources":["../../../../../core/plugins/ai-agent/services/ai-agent-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,cAAc,EAKd,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EAOnB,sBAAsB,EAEtB,WAAW,EACZ,MAAM,UAAU,CAAC;AAKlB;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,+CAA+C;IAC/C,UAAU,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;IAClD,4CAA4C;IAC5C,WAAW,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAC;IAC/C,kCAAkC;IAClC,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,oCAAoC;IACpC,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjG,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,yDAAyD;IACzD,SAAS,EAAE,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAChD,qDAAqD;IACrD,aAAa,EAAE,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1D,+DAA+D;IAC/D,sBAAsB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,6CAA6C;IAC7C,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,4CAA4C;IAC5C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,oEAAoE;IACpE,eAAe,EAAE,CACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,IAAI,EAAE,kBAAkB,EACxB,WAAW,CAAC,EAAE,WAAW,EAAE,EAC3B,OAAO,CAAC,EAAE,MAAM,KACb,IAAI,CAAC;IACV,uCAAuC;IACvC,iBAAiB,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACvF;AAsED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,uBAAuB,CAsclG"}