@vc-shell/framework 2.0.0-alpha.2 → 2.0.0-alpha.20

package/dist/chunks/vendor-w3c-keyname-CLxH8j-f.js

@@ -0,0 +1,92 @@
+var a = {
+  8: "Backspace",
+  9: "Tab",
+  10: "Enter",
+  12: "NumLock",
+  13: "Enter",
+  16: "Shift",
+  17: "Control",
+  18: "Alt",
+  20: "CapsLock",
+  27: "Escape",
+  32: " ",
+  33: "PageUp",
+  34: "PageDown",
+  35: "End",
+  36: "Home",
+  37: "ArrowLeft",
+  38: "ArrowUp",
+  39: "ArrowRight",
+  40: "ArrowDown",
+  44: "PrintScreen",
+  45: "Insert",
+  46: "Delete",
+  59: ";",
+  61: "=",
+  91: "Meta",
+  92: "Meta",
+  106: "*",
+  107: "+",
+  108: ",",
+  109: "-",
+  110: ".",
+  111: "/",
+  144: "NumLock",
+  145: "ScrollLock",
+  160: "Shift",
+  161: "Shift",
+  162: "Control",
+  163: "Control",
+  164: "Alt",
+  165: "Alt",
+  173: "-",
+  186: ";",
+  187: "=",
+  188: ",",
+  189: "-",
+  190: ".",
+  191: "/",
+  192: "`",
+  219: "[",
+  220: "\\",
+  221: "]",
+  222: "'"
+}, t = {
+  48: ")",
+  49: "!",
+  50: "@",
+  51: "#",
+  52: "$",
+  53: "%",
+  54: "^",
+  55: "&",
+  56: "*",
+  57: "(",
+  59: ":",
+  61: "+",
+  173: "_",
+  186: ":",
+  187: "+",
+  188: "<",
+  189: "_",
+  190: ">",
+  191: "?",
+  192: "~",
+  219: "{",
+  220: "|",
+  221: "}",
+  222: '"'
+}, n = typeof navigator < "u" && /Mac/.test(navigator.platform), y = typeof navigator < "u" && /MSIE \d|Trident\/(?:[7-9]|\d{2,})\..*rv:(\d+)/.exec(navigator.userAgent);
+for (var r = 0; r < 10; r++) a[48 + r] = a[96 + r] = String(r);
+for (var r = 1; r <= 24; r++) a[r + 111] = "F" + r;
+for (var r = 65; r <= 90; r++)
+  a[r] = String.fromCharCode(r + 32), t[r] = String.fromCharCode(r);
+for (var i in a) t.hasOwnProperty(i) || (t[i] = a[i]);
+function s(o) {
+  var f = n && o.metaKey && o.shiftKey && !o.ctrlKey && !o.altKey || y && o.shiftKey && o.key && o.key.length == 1 || o.key == "Unidentified", e = !f && o.key || (o.shiftKey ? t : a)[o.keyCode] || o.key || "Unidentified";
+  return e == "Esc" && (e = "Escape"), e == "Del" && (e = "Delete"), e == "Left" && (e = "ArrowLeft"), e == "Up" && (e = "ArrowUp"), e == "Right" && (e = "ArrowRight"), e == "Down" && (e = "ArrowDown"), e;
+}
+export {
+  a as b,
+  s as k
+};

package/dist/chunks/vendor-web-vitals-vrpLO1bu.js

@@ -0,0 +1,207 @@
+let N = -1;
+const m = (t) => {
+  addEventListener("pageshow", ((e) => {
+    e.persisted && (N = e.timeStamp, t(e));
+  }), !0);
+}, d = (t, e, i, n) => {
+  let r, s;
+  return (a) => {
+    e.value >= 0 && (a || n) && (s = e.value - (r ?? 0), (s || r === void 0) && (r = e.value, e.delta = s, e.rating = ((o, u) => o > u[1] ? "poor" : o > u[0] ? "needs-improvement" : "good")(e.value, i), t(e)));
+  };
+}, S = (t) => {
+  requestAnimationFrame((() => requestAnimationFrame((() => t()))));
+}, w = () => {
+  const t = performance.getEntriesByType("navigation")[0];
+  if (t && t.responseStart > 0 && t.responseStart < performance.now()) return t;
+}, f = () => w()?.activationStart ?? 0, l = (t, e = -1) => {
+  const i = w();
+  let n = "navigate";
+  return N >= 0 ? n = "back-forward-cache" : i && (document.prerendering || f() > 0 ? n = "prerender" : document.wasDiscarded ? n = "restore" : i.type && (n = i.type.replace(/_/g, "-"))), { name: t, value: e, rating: "good", delta: 0, entries: [], id: `v5-${Date.now()}-${Math.floor(8999999999999 * Math.random()) + 1e12}`, navigationType: n };
+}, b = /* @__PURE__ */ new WeakMap();
+function A(t, e) {
+  return b.get(t) || b.set(t, new e()), b.get(t);
+}
+class _ {
+  t;
+  i = 0;
+  o = [];
+  h(e) {
+    if (e.hadRecentInput) return;
+    const i = this.o[0], n = this.o.at(-1);
+    this.i && i && n && e.startTime - n.startTime < 1e3 && e.startTime - i.startTime < 5e3 ? (this.i += e.value, this.o.push(e)) : (this.i = e.value, this.o = [e]), this.t?.(e);
+  }
+}
+const v = (t, e, i = {}) => {
+  try {
+    if (PerformanceObserver.supportedEntryTypes.includes(t)) {
+      const n = new PerformanceObserver(((r) => {
+        Promise.resolve().then((() => {
+          e(r.getEntries());
+        }));
+      }));
+      return n.observe({ type: t, buffered: !0, ...i }), n;
+    }
+  } catch {
+  }
+}, I = (t) => {
+  let e = !1;
+  return () => {
+    e || (t(), e = !0);
+  };
+};
+let p = -1;
+const O = /* @__PURE__ */ new Set(), M = () => document.visibilityState !== "hidden" || document.prerendering ? 1 / 0 : 0, P = (t) => {
+  if (document.visibilityState === "hidden") {
+    if (t.type === "visibilitychange") for (const e of O) e();
+    isFinite(p) || (p = t.type === "visibilitychange" ? t.timeStamp : 0, removeEventListener("prerenderingchange", P, !0));
+  }
+}, T = () => {
+  if (p < 0) {
+    const t = f();
+    p = (document.prerendering ? void 0 : globalThis.performance.getEntriesByType("visibility-state").filter(((i) => i.name === "hidden" && i.startTime > t))[0]?.startTime) ?? M(), addEventListener("visibilitychange", P, !0), addEventListener("prerenderingchange", P, !0), m((() => {
+      setTimeout((() => {
+        p = M();
+      }));
+    }));
+  }
+  return { get firstHiddenTime() {
+    return p;
+  }, onHidden(t) {
+    O.add(t);
+  } };
+}, y = (t) => {
+  document.prerendering ? addEventListener("prerenderingchange", (() => t()), !0) : t();
+}, k = [1800, 3e3], W = (t, e = {}) => {
+  y((() => {
+    const i = T();
+    let n, r = l("FCP");
+    const s = v("paint", ((a) => {
+      for (const o of a) o.name === "first-contentful-paint" && (s.disconnect(), o.startTime < i.firstHiddenTime && (r.value = Math.max(o.startTime - f(), 0), r.entries.push(o), n(!0)));
+    }));
+    s && (n = d(t, r, k, e.reportAllChanges), m(((a) => {
+      r = l("FCP"), n = d(t, r, k, e.reportAllChanges), S((() => {
+        r.value = performance.now() - a.timeStamp, n(!0);
+      }));
+    })));
+  }));
+}, F = [0.1, 0.25], K = (t, e = {}) => {
+  const i = T();
+  W(I((() => {
+    let n, r = l("CLS", 0);
+    const s = A(e, _), a = (u) => {
+      for (const c of u) s.h(c);
+      s.i > r.value && (r.value = s.i, r.entries = s.o, n());
+    }, o = v("layout-shift", a);
+    o && (n = d(t, r, F, e.reportAllChanges), i.onHidden((() => {
+      a(o.takeRecords()), n(!0);
+    })), m((() => {
+      s.i = 0, r = l("CLS", 0), n = d(t, r, F, e.reportAllChanges), S((() => n()));
+    })), setTimeout(n));
+  })));
+};
+let $ = 0, C = 1 / 0, g = 0;
+const j = (t) => {
+  for (const e of t) e.interactionId && (C = Math.min(C, e.interactionId), g = Math.max(g, e.interactionId), $ = g ? (g - C) / 7 + 1 : 0);
+};
+let E;
+const H = () => E ? $ : performance.interactionCount ?? 0, z = () => {
+  "interactionCount" in performance || E || (E = v("event", j, { type: "event", buffered: !0, durationThreshold: 0 }));
+};
+let x = 0;
+class G {
+  u = [];
+  l = /* @__PURE__ */ new Map();
+  m;
+  p;
+  v() {
+    x = H(), this.u.length = 0, this.l.clear();
+  }
+  L() {
+    const e = Math.min(this.u.length - 1, Math.floor((H() - x) / 50));
+    return this.u[e];
+  }
+  h(e) {
+    if (this.m?.(e), !e.interactionId && e.entryType !== "first-input") return;
+    const i = this.u.at(-1);
+    let n = this.l.get(e.interactionId);
+    if (n || this.u.length < 10 || e.duration > i.P) {
+      if (n ? e.duration > n.P ? (n.entries = [e], n.P = e.duration) : e.duration === n.P && e.startTime === n.entries[0].startTime && n.entries.push(e) : (n = { id: e.interactionId, entries: [e], P: e.duration }, this.l.set(n.id, n), this.u.push(n)), this.u.sort(((r, s) => s.P - r.P)), this.u.length > 10) {
+        const r = this.u.splice(10);
+        for (const s of r) this.l.delete(s.id);
+      }
+      this.p?.(n);
+    }
+  }
+}
+const D = (t) => {
+  const e = globalThis.requestIdleCallback || setTimeout;
+  document.visibilityState === "hidden" ? t() : (t = I(t), addEventListener("visibilitychange", t, { once: !0, capture: !0 }), e((() => {
+    t(), removeEventListener("visibilitychange", t, { capture: !0 });
+  })));
+}, B = [200, 500], Q = (t, e = {}) => {
+  if (!globalThis.PerformanceEventTiming || !("interactionId" in PerformanceEventTiming.prototype)) return;
+  const i = T();
+  y((() => {
+    z();
+    let n, r = l("INP");
+    const s = A(e, G), a = (u) => {
+      D((() => {
+        for (const h of u) s.h(h);
+        const c = s.L();
+        c && c.P !== r.value && (r.value = c.P, r.entries = c.entries, n());
+      }));
+    }, o = v("event", a, { durationThreshold: e.durationThreshold ?? 40 });
+    n = d(t, r, B, e.reportAllChanges), o && (o.observe({ type: "first-input", buffered: !0 }), i.onHidden((() => {
+      a(o.takeRecords()), n(!0);
+    })), m((() => {
+      s.v(), r = l("INP"), n = d(t, r, B, e.reportAllChanges);
+    })));
+  }));
+};
+class J {
+  m;
+  h(e) {
+    this.m?.(e);
+  }
+}
+const q = [2500, 4e3], U = (t, e = {}) => {
+  y((() => {
+    const i = T();
+    let n, r = l("LCP");
+    const s = A(e, J), a = (u) => {
+      e.reportAllChanges || (u = u.slice(-1));
+      for (const c of u) s.h(c), c.startTime < i.firstHiddenTime && (r.value = Math.max(c.startTime - f(), 0), r.entries = [c], n());
+    }, o = v("largest-contentful-paint", a);
+    if (o) {
+      n = d(t, r, q, e.reportAllChanges);
+      const u = I((() => {
+        a(o.takeRecords()), o.disconnect(), n(!0);
+      })), c = (h) => {
+        h.isTrusted && (D(u), removeEventListener(h.type, c, { capture: !0 }));
+      };
+      for (const h of ["keydown", "click", "visibilitychange"]) addEventListener(h, c, { capture: !0 });
+      m(((h) => {
+        r = l("LCP"), n = d(t, r, q, e.reportAllChanges), S((() => {
+          r.value = performance.now() - h.timeStamp, n(!0);
+        }));
+      }));
+    }
+  }));
+}, R = [800, 1800], L = (t) => {
+  document.prerendering ? y((() => L(t))) : document.readyState !== "complete" ? addEventListener("load", (() => L(t)), !0) : setTimeout(t);
+}, V = (t, e = {}) => {
+  let i = l("TTFB"), n = d(t, i, R, e.reportAllChanges);
+  L((() => {
+    const r = w();
+    r && (i.value = Math.max(r.responseStart - f(), 0), i.entries = [r], n(!0), m((() => {
+      i = l("TTFB", 0), n = d(t, i, R, e.reportAllChanges), n(!0);
+    })));
+  }));
+};
+export {
+  V as $,
+  W as E,
+  K as L,
+  Q as S,
+  U as x
+};

package/dist/core/blade-navigation/bladeConfigRegistry.d.ts

@@ -0,0 +1,21 @@
+import type { BladeConfig } from "./types";
+/**
+ * Register blade config in global registry.
+ * Called by Vite-compiled defineBlade() at module import time.
+ * @internal — not part of the public API. Used by viteBladePlugin output.
+ */
+export declare function __registerBladeConfig(name: string, config: BladeConfig): void;
+/**
+ * Get blade config by registered name.
+ */
+export declare function getBladeConfig(name: string): BladeConfig | undefined;
+/**
+ * Get all registered blade configs (readonly).
+ */
+export declare function getAllBladeConfigs(): ReadonlyMap<string, BladeConfig>;
+/**
+ * Clear registry — for testing only.
+ * @internal
+ */
+export declare function __clearBladeConfigRegistry(): void;
+//# sourceMappingURL=bladeConfigRegistry.d.ts.map

package/dist/core/blade-navigation/bladeConfigRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bladeConfigRegistry.d.ts","sourceRoot":"","sources":["../../../core/blade-navigation/bladeConfigRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAK7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAErE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/core/blade-navigation/index.d.ts

@@ -0,0 +1,5 @@
+export { useBladeStack } from "../blade-navigation/useBladeStack";
+export { useBladeMessaging } from "../blade-navigation/useBladeMessaging";
+export * from "../blade-navigation/types";
+export { __registerBladeConfig, getBladeConfig, getAllBladeConfigs } from "../blade-navigation/bladeConfigRegistry";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/blade-navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/blade-navigation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/core/blade-navigation/types/index.d.ts

@@ -0,0 +1,270 @@
+import { Router } from "vue-router";
+import { AppContext, Component, ComponentOptionsBase, ComponentOptionsMixin, VNode, ComponentInternalInstance, VNodeTypes, Ref, InjectionKey, ComputedRef } from "vue";
+import type { ComponentPublicInstanceConstructor } from "../../../ui/utilities/vueUtils";
+import type { MenuItemConfig, MenuItemBadgeConfig } from "../../types/menu-types";
+import type { Breadcrumbs } from "../../../ui/types";
+import type { DisplayableError } from "../../utilities/error";
+/**
+ * @deprecated Blade pages no longer need to declare these props.
+ * Use `useBlade<TOptions>()` to access `param`, `options`, `expanded`, `closable`.
+ * VcBlade reads `expanded`/`closable` from BladeDescriptor automatically.
+ *
+ * These props are still passed by VcBladeSlot for backward compatibility
+ * and will be removed in the next major version.
+ */
+export type CoreBladeComponentProps = {
+    expanded?: boolean;
+    closable?: boolean;
+    param?: string;
+    options?: Record<string, any>;
+};
+export type CoreDynamicBladeComponentProps = {
+    model?: any;
+    composables?: any;
+};
+export type CoreBladeAdditionalSettings = {
+    url?: `/${string}`;
+    routable?: boolean;
+    permissions?: string | string[];
+    isWorkspace?: boolean;
+    isBlade?: boolean;
+    name?: string;
+    menuItem?: MenuItemConfig;
+};
+/**
+ * Menu item configuration for defineBlade().
+ * Clean subset of MenuItemConfig — deprecated fields (group, groupIcon, inGroupPriority) excluded.
+ */
+export interface BladeMenuItemConfig {
+    title: string;
+    icon: string;
+    priority: number;
+    groupConfig?: {
+        id: string;
+        title?: string;
+        icon?: string;
+        priority?: number;
+        permissions?: string | string[];
+        badge?: MenuItemBadgeConfig;
+    };
+    permissions?: string | string[];
+    badge?: MenuItemBadgeConfig;
+}
+/**
+ * Full blade definition passed to defineBlade().
+ * Includes `name` — the Vite plugin splits it: name → defineOptions, rest → registry.
+ */
+export interface BladeDefinition {
+    name: string;
+    url?: `/${string}`;
+    isWorkspace?: boolean;
+    routable?: boolean;
+    permissions?: string | string[];
+    menuItem?: BladeMenuItemConfig;
+}
+/**
+ * Blade config stored in the global registry (BladeDefinition minus name).
+ */
+export type BladeConfig = Omit<BladeDefinition, "name">;
+export interface CoreBladeExposed {
+    [x: string]: any;
+    title?: string;
+    reloadParent?: () => void;
+    reload?: () => void;
+}
+export interface IBladeInstance {
+    id: string;
+    expandable: boolean;
+    maximized: boolean;
+    error: DisplayableError | Error | string | null | undefined;
+    navigation: BladeVNode["props"]["navigation"] | undefined;
+    breadcrumbs: Breadcrumbs[] | undefined;
+    title?: string;
+    param?: string;
+    options?: Record<string, any>;
+}
+/**
+ * @deprecated Use `callParent(method, args)` from `useBlade()` instead of
+ * emitting `parent:call` events. Will be removed in the next major version.
+ */
+export interface IParentCallArgs {
+    method: keyof CoreBladeExposed;
+    args?: unknown;
+    callback?: (args: unknown) => void;
+}
+export interface BladeComponentInternalInstance extends ComponentInternalInstance {
+    vnode: VNode & BladeVNode;
+    appContext: AppContext & {
+        components: Record<string, BladeInstanceConstructor>;
+    };
+}
+export type ExtractedBladeOptions<T, U extends keyof T> = T[U];
+type Extractor<T> = Extract<T, ComponentPublicInstanceConstructor>;
+export type BladeInstanceConstructor<T extends Component = Component> = Extractor<T> & {
+    new (...args: any[]): InstanceType<Extractor<T>> & {
+        $: ComponentInternalInstance & {
+            exposed: CoreBladeExposed | InstanceType<Extractor<T>>["$"]["exposed"];
+        };
+        $props: InstanceType<Extractor<T>>["$props"] & CoreBladeComponentProps;
+    };
+} & ComponentOptionsBase<any, any, any, any, ComponentOptionsMixin, ComponentOptionsMixin, any, any, any> & CoreBladeAdditionalSettings;
+/** @deprecated This interface will be replaced in a future version. Avoid new usages. */
+export interface IBladeEvent<T extends Component = Component> {
+    blade: BladeInstanceConstructor<T> | {
+        name: string;
+    } | undefined;
+    options?: Record<string, any>;
+    param?: string;
+    onOpen?: () => void;
+    onClose?: () => void;
+    replaceCurrentBlade?: boolean;
+}
+export interface BladeNavigationPlugin {
+    router: Router;
+}
+export interface BladeRoutesRecord {
+    component: BladeInstanceConstructor;
+    name: string;
+    isWorkspace: boolean;
+    route: string;
+}
+type VNodeMountHook = (vnode: BladeVNode | VNode) => void;
+export interface BladeVNode extends VNode {
+    props: {
+        navigation: {
+            onOpen?: () => void;
+            onClose?: () => void;
+            onBeforeClose?: () => Promise<boolean | undefined>;
+            error?: Ref<Error | null>;
+            instance: CoreBladeExposed | undefined | null;
+            idx: number;
+            isVisible?: boolean;
+        };
+        onVnodeUnmounted?: VNodeMountHook | VNodeMountHook[];
+        onVnodeMounted?: VNodeMountHook | VNodeMountHook[];
+    } & 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 by VcBlade via setBladeTitle() */
+    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 — destroys old, creates new at same position */
+    replaceCurrentBlade(event: BladeOpenEvent & {
+        parentId?: string;
+    }): Promise<void>;
+    /** Cover the current blade — hides it and opens a new blade on top (closing reveals the hidden blade) */
+    coverCurrentBlade(event: BladeOpenEvent & {
+        parentId?: string;
+    }): Promise<void>;
+    /** Close all children of a blade (deepest first, respecting guards) */
+    closeChildren(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 VcBlade when title prop changes) */
+    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 declare const BladeDataKey: InjectionKey<ComputedRef<Record<string, unknown>> | Ref<Record<string, unknown>>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/blade-navigation/useBladeMessaging.d.ts

@@ -0,0 +1,18 @@
+import type { IBladeMessaging, IBladeStack } from "../blade-navigation/types";
+/**
+ * Creates the inter-blade messaging system.
+ *
+ * Uses a Map<bladeId, Record<string, Function>> to store exposed methods.
+ * Child blades call parent methods via direct ID lookup (no tree walking).
+ *
+ * @param bladeStack - BladeStack for looking up blade descriptors by ID
+ * @internal
+ */
+export declare function createBladeMessaging(bladeStack: IBladeStack): IBladeMessaging;
+/**
+ * Composable for accessing BladeMessaging from within a component.
+ * Must be used after BladeMessaging is provided via BladeMessagingKey.
+ * @internal
+ */
+export declare function useBladeMessaging(): IBladeMessaging;
+//# sourceMappingURL=useBladeMessaging.d.ts.map

package/dist/core/blade-navigation/useBladeMessaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBladeMessaging.d.ts","sourceRoot":"","sources":["../../../core/blade-navigation/useBladeMessaging.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGjF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,WAAW,GAAG,eAAe,CA4C7E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,CAMnD"}

package/dist/core/blade-navigation/useBladeStack.d.ts

@@ -0,0 +1,19 @@
+import type { IBladeRegistry } from "../composables/useBladeRegistry";
+import type { IBladeStack } from "../blade-navigation/types";
+/**
+ * Creates the BladeStack state machine.
+ *
+ * The stack manages an ordered list of BladeDescriptor objects (plain data).
+ * All mutations go through explicit actions — no direct VNode manipulation.
+ *
+ * @param bladeRegistry - Registry for resolving blade names → components
+ * @internal
+ */
+export declare function createBladeStack(bladeRegistry: IBladeRegistry, hasAccess?: (permissions: string | string[] | undefined) => boolean): IBladeStack;
+/**
+ * Composable for accessing the BladeStack from within a component.
+ * Must be used after BladeStack is provided via BladeStackKey.
+ * @internal
+ */
+export declare function useBladeStack(): IBladeStack;
+//# sourceMappingURL=useBladeStack.d.ts.map

package/dist/core/blade-navigation/useBladeStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBladeStack.d.ts","sourceRoot":"","sources":["../../../core/blade-navigation/useBladeStack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAmC,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAUjG;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,cAAc,EAC7B,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,KAAK,OAAO,GAClE,WAAW,CAqXb;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAM3C"}