@vc-shell/framework 2.0.0-alpha.3 → 2.0.0-alpha.31

package/dist/core/blade-navigation/utils/bladeRouterGuard.d.ts

@@ -0,0 +1,32 @@
+import type { RouteLocationNormalized } from "vue-router";
+import type { Router } from "vue-router";
+import type { UseBladeRegistryReturn } from "../../composables/useBladeRegistry";
+import type { IBladeStack } from "../../blade-navigation/types";
+/**
+ * Result of the blade router guard.
+ *
+ * - `undefined` — allow navigation (no redirect)
+ * - `false` — cancel navigation (e.g. beforeClose guard prevented closing)
+ * - `{ path, query, replace }` — redirect to cleaned-up URL
+ */
+export type BladeGuardResult = undefined | false | {
+    path: string;
+    query: Record<string, string>;
+    replace: true;
+};
+/**
+ * Router guard that syncs URL navigation with the BladeStack.
+ *
+ * Determines whether a navigation target is a real Vue Router page
+ * or a blade URL handled by the catch-all route:
+ *
+ * - **Real child routes** (e.g. "Platform", "Dashboard"): clears any open
+ *   blades and lets Vue Router render the page.
+ * - **Blade catch-all route**: parses URL segments and restores the
+ *   blade stack (workspace + optional child blade).
+ *
+ * The catch-all route is identified by `meta.bladeCatchAll`, which is set
+ * by the BladeNavigationPlugin when it registers the catch-all.
+ */
+export declare function bladeRouterGuard(to: RouteLocationNormalized, bladeStack: IBladeStack, bladeRegistry: UseBladeRegistryReturn, hasAccess?: (permissions: string | string[] | undefined) => boolean, router?: Router): Promise<BladeGuardResult>;
+//# sourceMappingURL=bladeRouterGuard.d.ts.map

package/dist/core/blade-navigation/utils/bladeRouterGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bladeRouterGuard.d.ts","sourceRoot":"","sources":["../../../../core/blade-navigation/utils/bladeRouterGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAyBlH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,uBAAuB,EAC3B,UAAU,EAAE,WAAW,EACvB,aAAa,EAAE,sBAAsB,EACrC,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,KAAK,OAAO,EACnE,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAqD3B"}

package/dist/core/blade-navigation/utils/navigateToMainRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigateToMainRoute.d.ts","sourceRoot":"","sources":["../../../../core/blade-navigation/utils/navigateToMainRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQzF"}

package/dist/core/blade-navigation/utils/restoreFromUrl.d.ts

@@ -0,0 +1,24 @@
+import type { Router } from "vue-router";
+import type { IBladeRegistry } from "../../composables/useBladeRegistry";
+import type { IBladeStack, ParsedBladeUrl } from "../../blade-navigation/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
+ * @param hasAccess - Optional permission check function
+ * @param router - Optional router for redirecting on access denial
+ * @param routeParams - Route params to preserve on redirect (e.g. sellerId for tenant prefix)
+ * @returns `true` if the URL needs cleanup (non-routable blade was skipped)
+ */
+export declare function restoreFromUrl(bladeStack: IBladeStack, bladeRegistry: IBladeRegistry, parsed: ParsedBladeUrl, hasAccess?: (permissions: string | string[] | undefined) => boolean, router?: Router, routeParams?: Record<string, string>): Promise<boolean>;
+//# sourceMappingURL=restoreFromUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restoreFromUrl.d.ts","sourceRoot":"","sources":["../../../../core/blade-navigation/utils/restoreFromUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,WAAW,EACvB,aAAa,EAAE,cAAc,EAC7B,MAAM,EAAE,cAAc,EACtB,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,KAAK,OAAO,EACnE,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,OAAO,CAAC,CAoElB"}

package/dist/core/blade-navigation/utils/urlSync.d.ts

@@ -0,0 +1,54 @@
+import type { Router } from "vue-router";
+import type { BladeDescriptor, IBladeStack, ParsedBladeUrl } from "../../blade-navigation/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/core/blade-navigation/utils/urlSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlSync.d.ts","sourceRoot":"","sources":["../../../../core/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,8BAA8B,CAAC;AAEjG;;;;;;;;;;;;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/core/composables/bladeContext/index.d.ts

@@ -0,0 +1,29 @@
+import { type MaybeRefOrGetter, type ComputedRef } from "vue";
+/**
+ * Exposes blade data for external widgets, extensions, and nested components.
+ * Must be called in blade's `<script setup>`.
+ *
+ * All ref/computed values in the provided object are **automatically unwrapped**
+ * so consumers can access them directly without `.value`.
+ *
+ * @example
+ * ```ts
+ * defineBladeContext({ item, disabled });
+ * // consumer: ctx.value.item — already unwrapped, no .value needed
+ * ```
+ */
+export declare function defineBladeContext(data: MaybeRefOrGetter<Record<string, unknown>>): void;
+/**
+ * Injects blade context provided by the nearest ancestor blade via `defineBladeContext`.
+ * Returns a ComputedRef — access fields via `.value`.
+ * Nested refs are already unwrapped by `defineBladeContext`.
+ * Throws if no context is found.
+ *
+ * @example
+ * ```ts
+ * const ctx = injectBladeContext();
+ * const entityId = computed(() => ctx.value.id as string);
+ * ```
+ */
+export declare function injectBladeContext(): ComputedRef<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/bladeContext/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAiBzG;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAKxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMzE"}

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

@@ -8,13 +8,13 @@ export * from "../composables/useApiClient";
 export * from "../composables/useLoading";
 export * from "../composables/useErrorHandler";
 export * from "../composables/useAssets";
+export * from "../composables/useAssetsManager";
 export * from "../composables/useMenuService";
 export * from "../composables/useBeforeUnload";
 export * from "../composables/useLanguages";
 export * from "../composables/useBreadcrumbs";
 export * from "../composables/useAppInsights";
 export * from "../composables/useTheme";
-export * from "../composables/useWidgets";
 export * from "../composables/useDashboard";
 export * from "../composables/useAppBarWidget";
 export * from "../composables/useSettingsMenu";
@@ -23,4 +23,10 @@ export * from "../composables/useDynamicProperties";
 export * from "../composables/useBlade";
 export * from "../composables/useSidebarState";
 export * from "../composables/useWebVitals";
+export * from "../composables/useBladeWidgets";
+export * from "../composables/bladeContext";
+export * from "../composables/useModificationTracker";
+export * from "../composables/useMenuExpanded";
+export * from "../composables/usePopup";
+export * from "../composables/useResponsive";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/composables/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/composables/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppBarMobileButtons/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAG9H,MAAM,MAAM,4BAA4B,GAAG,2BAA2B,CAAC;AAIvE,wBAAgB,iCAAiC,IAAI,2BAA2B,CAgB/E;AAED,wBAAgB,sBAAsB,IAAI,4BAA4B,CAOrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppBarMobileButtons/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,2BAA2B,EAC5B,MAAM,+CAA+C,CAAC;AAGvD,MAAM,MAAM,4BAA4B,GAAG,2BAA2B,CAAC;AAIvE,wBAAgB,iCAAiC,IAAI,2BAA2B,CAgB/E;AAED,wBAAgB,sBAAsB,IAAI,4BAA4B,CAOrE"}

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

@@ -2,6 +2,7 @@ import { type InjectionKey } from "vue";
 import { AppInsightsPluginOptions } from "vue3-application-insights";
 import { ApplicationInsights } from "@microsoft/applicationinsights-web";
 export declare const AppInsightsOptionsKey: InjectionKey<AppInsightsPluginOptions>;
+export declare const AppInsightsInstanceKey: InjectionKey<ApplicationInsights | null>;
 export interface UseAppInsightsReturn {
     setupPageTracking: {
         beforeEach: (route: {
@@ -12,7 +13,7 @@ export interface UseAppInsightsReturn {
             fullPath: string;
         }) => void;
     };
-    appInsights: ApplicationInsights;
+    appInsights: ApplicationInsights | null;
 }
 /** @deprecated Use UseAppInsightsReturn instead */
 export type IUseAppInsights = UseAppInsightsReturn;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppInsights/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAiC,MAAM,2BAA2B,CAAC;AAGpG,OAAO,EAAE,mBAAmB,EAAW,MAAM,oCAAoC,CAAC;AAElF,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,wBAAwB,CAAgC,CAAC;AAE1G,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE;QACjB,UAAU,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QAC9C,SAAS,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;KAChE,CAAC;IACF,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD,wBAAgB,cAAc,IAAI,oBAAoB,CAuCrD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppInsights/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAW,MAAM,oCAAoC,CAAC;AAElF,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,wBAAwB,CAAgC,CAAC;AAC1G,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,mBAAmB,GAAG,IAAI,CAAiC,CAAC;AAE9G,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE;QACjB,UAAU,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QAC9C,SAAS,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;KAChE,CAAC;IACF,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACzC;AAED,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD,wBAAgB,cAAc,IAAI,oBAAoB,CAuCrD"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAssets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,KAAK,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrG,MAAM,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,CAAC;IAC3F,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,CAAC;IACxF,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC;AAwDzC,wBAAgB,SAAS,IAAI,eAAe,CAwE3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAssets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,KAAK,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrG,MAAM,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,CAAC;IAC3F,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,CAAC;IACxF,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC;AAyDzC,wBAAgB,SAAS,IAAI,eAAe,CA8E3C"}

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

@@ -0,0 +1,24 @@
+import { Ref, ComputedRef } from "vue";
+export interface AssetLike {
+    url?: string;
+    name?: string;
+    sortOrder?: number;
+    [key: string]: any;
+}
+export interface UseAssetsManagerOptions {
+    uploadPath: () => string;
+    confirmRemove?: () => Promise<boolean> | boolean;
+    assetKey?: string;
+    concurrency?: number;
+}
+export interface UseAssetsManagerReturn {
+    items: Ref<AssetLike[]>;
+    upload: (files: FileList, startingSortOrder?: number) => Promise<void>;
+    remove: (item: AssetLike) => Promise<void>;
+    removeMany: (items: AssetLike[]) => Promise<void>;
+    reorder: (items: AssetLike[]) => void;
+    updateItem: (item: AssetLike) => void;
+    loading: ComputedRef<boolean>;
+}
+export declare function useAssetsManager(source: Ref<AssetLike[] | undefined | null>, options: UseAssetsManagerOptions): UseAssetsManagerReturn;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAssetsManager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,GAAG,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAK7D,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IACtC,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC/B;AA6DD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,EAC3C,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CA4FxB"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAsync/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAc,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAYrE,MAAM,MAAM,WAAW,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAE,SAAQ,UAAU;IAC/E,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,wEAAwE;IACxE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC;CACnD;AAED,6CAA6C;AAC7C,MAAM,MAAM,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAEtF,wBAAgB,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EACpD,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACzC,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAgDjC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAsync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAc,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAYrE,MAAM,MAAM,WAAW,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAE,SAAQ,UAAU;IAC/E,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,wEAAwE;IACxE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC;CACnD;AAED,6CAA6C;AAC7C,MAAM,MAAM,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAEtF,wBAAgB,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EACpD,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACzC,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAgDjC"}

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

@@ -1,50 +1,57 @@
-import { type ComputedRef } from "vue";
-import type { BladeOpenEvent, IBladeInstance } from "../../../shared/components/blade-navigation/types";
-/** Type alias for the return value of useBlade() */
-export type UseBladeReturn = ComputedRef<IBladeInstance>;
-export interface UseBladeContextReturn {
+import { type ComputedRef, type MaybeRef } from "vue";
+import type { BladeOpenEvent, IBladeBanner } from "../../blade-navigation/types";
+export type { IBladeBanner } from "../../blade-navigation/types";
+export interface UseBladeReturn<TOptions = Record<string, unknown>> {
     readonly id: ComputedRef<string>;
     readonly param: ComputedRef<string | undefined>;
-    readonly options: ComputedRef<Record<string, unknown> | undefined>;
+    readonly options: ComputedRef<TOptions | undefined>;
     readonly query: ComputedRef<Record<string, string> | undefined>;
     readonly closable: ComputedRef<boolean>;
     readonly expanded: ComputedRef<boolean>;
-    openBlade(event: BladeOpenEvent): Promise<void>;
+    readonly name: ComputedRef<string>;
+    /** @deprecated Use `defineBladeContext()` instead */
+    provideBladeData(data: MaybeRef<Record<string, unknown>>): void;
+    openBlade(event: BladeOpenEvent & {
+        isWorkspace?: boolean;
+    }): Promise<void>;
     closeSelf(): Promise<boolean>;
+    closeChildren(): Promise<void>;
     replaceWith(event: BladeOpenEvent): Promise<void>;
+    coverWith(event: BladeOpenEvent): Promise<void>;
     callParent<T = unknown>(method: string, args?: unknown): Promise<T>;
-    exposeToChildren(methods: Record<string, (...args: unknown[]) => unknown>): void;
+    exposeToChildren(methods: Record<string, (...args: any[]) => any>): void;
     onBeforeClose(guard: () => Promise<boolean>): void;
+    onActivated(callback: () => void): void;
+    onDeactivated(callback: () => void): void;
     setError(error: unknown): void;
     clearError(): void;
+    addBanner(options: Omit<IBladeBanner, "id" | "_system">): string;
+    removeBanner(id: string): void;
+    clearBanners(): void;
 }
 /**
- * Composable for accessing the current blade instance (legacy API).
+ * Unified blade composable — works **everywhere**.
  *
- * Returns a ComputedRef<IBladeInstance> — the same type as before.
- * For the new extended API with actions (openBlade, closeSelf, etc.),
- * use `useBladeContext()` instead.
+ * Inside a blade (rendered by VcBladeSlot): full API — identity, navigation,
+ * communication, guards, error management.
  *
- * @deprecated Use useBladeContext() instead.
- * @returns The current blade instance (ComputedRef)
- */
-export declare function useBlade(): UseBladeReturn;
-/**
- * Extended blade context composable (new API).
- *
- * Provides identity (id, param, options), actions (openBlade, closeSelf),
- * communication (callParent, exposeToChildren), guards, and error management.
- *
- * Must be called inside a component rendered by VcBladeSlot (new render layer).
- * Falls back gracefully when BladeDescriptor is not yet provided (old render layer).
+ * Outside a blade (dashboard cards, notification templates, composables):
+ * navigation methods (openBlade) work via singletons; blade-specific methods
+ * throw a descriptive runtime error on invocation.
  *
- * @example
+ * @example Inside blade
  * ```ts
- * const { param, options, openBlade, closeSelf, callParent } = useBladeContext();
+ * const { id, param, openBlade, closeSelf, callParent } = useBlade();
  * openBlade({ name: "OrderDetails", param: orderId });
  * const result = await callParent("reload");
  * closeSelf();
  * ```
+ *
+ * @example Outside blade (dashboard card)
+ * ```ts
+ * const { openBlade } = useBlade();
+ * openBlade({ name: "OrderDetails", param: orderId });
+ * ```
  */
-export declare function useBladeContext(): UseBladeContextReturn;
+export declare function useBlade<TOptions = Record<string, unknown>>(): UseBladeReturn<TOptions>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBlade/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAOzD,OAAO,KAAK,EAER,cAAc,EAGd,cAAc,EACjB,MAAM,2CAA2C,CAAC;AAEnD,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IACnE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAExC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;IAEjF,aAAa,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAEnD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAUzC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAmGvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBlade/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAQxH,OAAO,KAAK,EAAE,cAAc,EAAe,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC9F,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAQjE,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEhE,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,qDAAqD;IACrD,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAEhE,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;IAEzE,aAAa,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAEnD,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,UAAU,IAAI,IAAI,CAAC;IAEnB,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,IAAI,IAAI,CAAC;CACtB;AAUD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,CAAC,QAAQ,CAAC,CAsQvF"}

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

@@ -0,0 +1,17 @@
+import type { UseBladeFormOptions, UseBladeFormReturn } from "./types";
+export type { UseBladeFormOptions, UseBladeFormReturn, BladeFormInjection } from "./types";
+/**
+ * Unified form state management for blades.
+ *
+ * Encapsulates vee-validate form, modification tracking, browser unload guard,
+ * and blade close guard into a single composable with lifecycle-based API.
+ *
+ * **Must be called from component setup()** — uses provide() internally.
+ *
+ * Unlike useModificationTracker (which creates a separate currentValue clone),
+ * this composable tracks changes directly on the passed `data` ref.
+ * The template binds to `data` via v-model — edits go straight into
+ * the ref and are detected by a deep watcher against a pristine snapshot.
+ */
+export declare function useBladeForm<T>(options: UseBladeFormOptions<T>): UseBladeFormReturn;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBladeForm/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEvE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAgC3F;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAoGnF"}

package/dist/core/composables/useBladeForm/types.d.ts

@@ -0,0 +1,39 @@
+import type { ComputedRef, MaybeRefOrGetter, Ref } from "vue";
+import type { useForm } from "vee-validate";
+export interface UseBladeFormOptions<T> {
+    /** Reactive data object for the form */
+    data: Ref<T>;
+    /** Additional condition for canSave (e.g., computed(() => !isSkuValidating.value)) */
+    canSaveOverride?: ComputedRef<boolean>;
+    /**
+     * Auto onBeforeClose guard behavior:
+     * - true (default): show unsaved changes dialog when isModified
+     * - false: no auto guard
+     * - ComputedRef<boolean>: custom guard condition (combined with isModified via &&)
+     */
+    autoBeforeClose?: boolean | ComputedRef<boolean>;
+    /** Disable auto useBeforeUnload registration (default: true = enabled) */
+    autoBeforeUnload?: boolean;
+    /** Custom message for unsaved changes dialog */
+    closeConfirmMessage?: MaybeRefOrGetter<string>;
+    /**
+     * Custom revert handler. Called by revert().
+     * If not provided, revert() does data.value = cloneDeep(pristine).
+     */
+    onRevert?: () => void | Promise<void>;
+}
+export interface UseBladeFormReturn {
+    setBaseline: () => void;
+    revert: () => void | Promise<void>;
+    canSave: ComputedRef<boolean>;
+    isModified: ComputedRef<boolean>;
+    isReady: ComputedRef<boolean>;
+    formMeta: ReturnType<typeof useForm>["meta"];
+    setFieldError: ReturnType<typeof useForm>["setFieldError"];
+    errorBag: ReturnType<typeof useForm>["errorBag"];
+}
+export interface BladeFormInjection {
+    isModified: ComputedRef<boolean>;
+    canSave: ComputedRef<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/composables/useBladeForm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBladeForm/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,wCAAwC;IACxC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACb,sFAAsF;IACtF,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjD,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7C,aAAa,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC;IAC3D,QAAQ,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC/B"}

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

@@ -0,0 +1,33 @@
+/**
+ * useBladeNavigation adapter — maps the legacy IUseBladeNavigation API
+ * onto the new BladeStack + BladeMessaging system.
+ *
+ * Drop-in replacement for the old useBladeNavigation.
+ * Consumer code keeps working; deprecation warnings guide migration.
+ */
+import { Component, ComputedRef } from "vue";
+import { RouteLocationNormalized, RouteLocationRaw, NavigationFailure } from "vue-router";
+import { BladeVNode, IBladeEvent, IParentCallArgs, BladeInstanceConstructor } from "../../blade-navigation/types";
+export interface IUseBladeNavigation {
+    readonly blades: ComputedRef<BladeVNode[]>;
+    readonly activeWorkspace: ComputedRef<BladeVNode | undefined>;
+    readonly currentBladeNavigationData: ComputedRef<BladeVNode["props"]["navigation"] | undefined>;
+    openBlade: <Blade extends Component>(args: IBladeEvent<Blade>, isWorkspace?: boolean) => Promise<void | NavigationFailure>;
+    closeBlade: (index: number) => Promise<boolean>;
+    goToRoot: () => RouteLocationRaw;
+    onParentCall: (args: IParentCallArgs, currentBladeIndex?: number) => void;
+    onBeforeClose: (cb: () => Promise<boolean | undefined>) => void;
+    resolveBladeByName: (name: string) => BladeInstanceConstructor | undefined;
+    routeResolver: (to: RouteLocationNormalized) => Promise<RouteLocationRaw | undefined> | RouteLocationRaw | undefined;
+    setNavigationQuery: (query: Record<string, string | number>) => void;
+    getNavigationQuery: () => Record<string, string | number> | undefined;
+    setBladeError: (bladeIdx: number, error: unknown) => void;
+    clearBladeError: (bladeIdx: number) => void;
+}
+/**
+ * Reset adapter's cached computeds. For use in test teardown only.
+ * @internal
+ */
+export declare function _resetAdapterState(): void;
+export declare function useBladeNavigation(): IUseBladeNavigation;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBladeNavigationAdapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAA8C,SAAS,EAAE,WAAW,EAAY,MAAM,KAAK,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQ1F,OAAO,EACL,UAAU,EACV,WAAW,EACX,eAAe,EACf,wBAAwB,EAGzB,MAAM,8BAA8B,CAAC;AAmBtC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC9D,QAAQ,CAAC,0BAA0B,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,CAAC;IAChG,SAAS,EAAE,CAAC,KAAK,SAAS,SAAS,EACjC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EACxB,WAAW,CAAC,EAAE,OAAO,KAClB,OAAO,CAAC,IAAI,GAAG,iBAAiB,CAAC,CAAC;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,QAAQ,EAAE,MAAM,gBAAgB,CAAC;IACjC,YAAY,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,KAAK,IAAI,CAAC;IAChE,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;IAC3E,aAAa,EAAE,CAAC,EAAE,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACrH,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACrE,kBAAkB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IACtE,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAiCD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAiED,wBAAgB,kBAAkB,IAAI,mBAAmB,CAgQxD"}

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

@@ -1,5 +1,5 @@
 import { App, ComputedRef } from "vue";
-import type { BladeInstanceConstructor } from "../../../shared/components/blade-navigation/types";
+import type { BladeInstanceConstructor } from "../../blade-navigation/types";
 /**
  * Interface for blade registration data
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBladeRegistry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAgC,WAAW,EAA2B,MAAM,KAAK,CAAC;AAC9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAK1F;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,wBAAwB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA0B,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACvF,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,sBAAsB,GAAG,SAAS,CAAC;IAC/D,kCAAkC;IAClC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;IAC1E,yEAAyE;IACzE,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE,GAAG,SAAS,CAAC;CAChG;AAED,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,cAAc,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9G;AAeD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,sBAAsB,CAwJpE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAQzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBladeRegistry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAgC,WAAW,EAA2B,MAAM,KAAK,CAAC;AAC9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAQ7E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,wBAAwB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA0B,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACvF,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,sBAAsB,GAAG,SAAS,CAAC;IAC/D,kCAAkC;IAClC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;IAC1E,yEAAyE;IACzE,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE,GAAG,SAAS,CAAC;CAChG;AAED,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,cAAc,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9G;AAeD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,sBAAsB,CA+KpE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAQzD"}

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

@@ -0,0 +1,49 @@
+import { type ComputedRef, type Ref } from "vue";
+import type { IWidgetTrigger } from "../../services/widget-service";
+export interface HeadlessWidgetDeclaration {
+    id: string;
+    icon: string;
+    title: string;
+    badge?: Ref<number | string> | ComputedRef<number | string>;
+    loading?: Ref<boolean> | ComputedRef<boolean>;
+    disabled?: Ref<boolean> | ComputedRef<boolean> | boolean;
+    isVisible?: ComputedRef<boolean> | Ref<boolean> | boolean;
+    onClick?: () => void;
+    onRefresh?: () => void | Promise<void>;
+}
+export interface UseBladeWidgetsReturn {
+    /** Call trigger.onRefresh on a specific widget */
+    refresh: (widgetId: string) => void;
+    /** Call trigger.onRefresh on all blade widgets that have a trigger */
+    refreshAll: () => void;
+}
+/**
+ * Declarative headless widget registration for blades.
+ * Automatically registers on mount, unregisters on unmount.
+ * Gets bladeId from blade context (BladeDescriptorKey).
+ *
+ * @example
+ * ```ts
+ * const { refreshAll } = useBladeWidgets([
+ *   { id: "OffersWidget", icon: "lucide-tag", title: "OFFERS.TITLE",
+ *     badge: count, onClick: () => openBlade({ name: "Offers" }) },
+ * ]);
+ * ```
+ */
+export declare function useBladeWidgets(widgets: HeadlessWidgetDeclaration[]): UseBladeWidgetsReturn;
+export type { IWidgetScope } from "../../services/widget-service";
+/**
+ * Registers a trigger contract (onRefresh, onClick, badge) for an external
+ * component-based widget, so the hosting blade can call `refresh()` / `refreshAll()`.
+ *
+ * Uses provide/inject — no props or IDs needed. Must be called inside a widget
+ * component rendered by WidgetContainer.
+ *
+ * @example
+ * ```ts
+ * // Inside an external widget component:
+ * useWidgetTrigger({ onRefresh: loadData });
+ * ```
+ */
+export declare function useWidgetTrigger(trigger: IWidgetTrigger): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBladeWidgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,GAAG,EAAkC,MAAM,KAAK,CAAC;AAGjF,OAAO,KAAK,EAAkC,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAKpG,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACzD,SAAS,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,sEAAsE;IACtE,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,qBAAqB,CAiD3F;AAKD,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAO9D"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useConnectionStatus/index.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,SAAS,qCAAY,CAAC;AAE5B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC;CACtC;AAED,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAE5D,wBAAgB,mBAAmB,IAAI,yBAAyB,CA8B/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useConnectionStatus/index.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,SAAS,qCAAY,CAAC;AAE5B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC;CACtC;AAED,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAE5D,wBAAgB,mBAAmB,IAAI,yBAAyB,CA+B/D"}