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

package/core/types/index.ts

@@ -3,6 +3,9 @@ import { CoreBladeExposed } from "../../shared";
 import { ComponentPublicInstanceConstructor } from "../../shared/utilities";
 import { IBladeInstance } from "../../shared/components/blade-navigation/types";
 
+// AI Agent types are now part of the ai-agent plugin
+// export * from "./plugins/ai-agent/types";
+
 // Type instead of interface here is workaround for:
 // https://github.com/microsoft/TypeScript/issues/15300
 // (index signature is missing for interfaces in Typescript,
@@ -130,6 +133,28 @@ export interface RequestPasswordResult {
   errorCode?: string;
 }
 
+/** Option for select filters */
+export interface IFilterOption {
+  value: string;
+  label: string;
+}
+
+/**
+ * Column filter configuration.
+ * - `true` — text filter, backend field = column.id
+ * - `"fieldName"` — text filter, backend field = fieldName
+ * - `{ options: [...] }` — select filter (single), backend field = column.id
+ * - `{ options: [...], multiple: true }` — select filter (multi), backend field = column.id
+ * - `{ field: "x", options: [...] }` — select filter, backend field = x
+ * - `{ range: ["startDate", "endDate"] }` — date range filter
+ */
+export type IColumnFilterConfig =
+  | true
+  | string
+  | { options: IFilterOption[]; multiple?: boolean }
+  | { field: string; options: IFilterOption[]; multiple?: boolean }
+  | { range: [string, string] };
+
 export type ITableColumnsBase = {
   id: string;
   title: string | ComputedRef<string>;
@@ -156,6 +181,11 @@ export type ITableColumnsBase = {
   editable?: boolean;
   currencyField?: string;
   rules?: IValidationRules;
+  /**
+   * Column filter configuration.
+   * @see IColumnFilterConfig for usage examples
+   */
+  filter?: IColumnFilterConfig;
   // Mobile view specific fields
   mobilePosition?: "status" | "image" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
   mobileVisible?: boolean; // Show in mobile view
@@ -224,6 +254,8 @@ export type MenuItemBadgeConfig =
   | ComputedRef<number | string | undefined>
   | (() => number | string | undefined);
 
+export type { ShellFeature, ShellContext } from "./shell-feature";
+
 export interface MenuItemConfig {
   id?: string;
   /**

package/core/types/services.ts

@@ -0,0 +1,194 @@
+import type { App, Ref } from "vue";
+
+/**
+ * Service lifecycle interface for managing service creation and cleanup
+ */
+export interface ServiceLifecycle<T> {
+  /**
+   * Creates a new instance of the service
+   */
+  create(): T;
+
+  /**
+   * Provides the service to the Vue application
+   */
+  provide(app: App): void;
+
+  /**
+   * Cleanup function called when the service is no longer needed
+   */
+  cleanup(): void;
+}
+
+/**
+ * Interface for services that support pre-registration of items
+ * before the service is fully initialized
+ */
+export interface PreregistrationQueue<T> {
+  /**
+   * Items waiting to be registered
+   */
+  readonly items: readonly T[];
+
+  /**
+   * Register an item to be processed when the service initializes
+   */
+  register(item: T): void;
+
+  /**
+   * Flush all pending items and return them for processing
+   */
+  flush(): T[];
+
+  /**
+   * Clear the queue without processing
+   */
+  clear(): void;
+}
+
+/**
+ * Base interface for registry-type services
+ */
+export interface RegistryService<TKey, TItem> {
+  /**
+   * Register a new item in the registry
+   */
+  register(key: TKey, item: TItem): void;
+
+  /**
+   * Unregister an item from the registry
+   */
+  unregister(key: TKey): boolean;
+
+  /**
+   * Get an item by its key
+   */
+  get(key: TKey): TItem | undefined;
+
+  /**
+   * Check if an item exists in the registry
+   */
+  has(key: TKey): boolean;
+
+  /**
+   * Get all registered items
+   */
+  getAll(): Map<TKey, TItem>;
+
+  /**
+   * Clear all items from the registry
+   */
+  clear(): void;
+}
+
+/**
+ * Interface for services that provide reactive lists
+ */
+export interface ListService<T> {
+  /**
+   * Reactive reference to the list items
+   */
+  items: Ref<T[]>;
+
+  /**
+   * Add an item to the list
+   */
+  add(item: T): void;
+
+  /**
+   * Remove an item from the list
+   */
+  remove(item: T): boolean;
+
+  /**
+   * Find an item in the list
+   */
+  find(predicate: (item: T) => boolean): T | undefined;
+
+  /**
+   * Filter items in the list
+   */
+  filter(predicate: (item: T) => boolean): T[];
+}
+
+/**
+ * Interface for services with ordered items
+ */
+export interface OrderedListService<T> extends ListService<T> {
+  /**
+   * Reorder an item to a new position
+   */
+  reorder(fromIndex: number, toIndex: number): void;
+
+  /**
+   * Get items sorted by priority
+   */
+  getSorted(): T[];
+}
+
+/**
+ * Result type for async service operations
+ */
+export interface ServiceResult<T> {
+  success: boolean;
+  data?: T;
+  error?: {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+  };
+}
+
+/**
+ * Interface for services that support subscription to changes
+ */
+export interface ObservableService<T> {
+  /**
+   * Subscribe to changes
+   */
+  subscribe(callback: (value: T) => void): () => void;
+
+  /**
+   * Get the current value
+   */
+  getValue(): T;
+}
+
+/**
+ * Type for widget registration
+ */
+export interface WidgetRegistration<TProps = Record<string, unknown>> {
+  id: string;
+  component: unknown;
+  props?: TProps;
+  order?: number;
+  isVisible?: boolean | (() => boolean);
+}
+
+/**
+ * Type for menu item registration
+ */
+export interface MenuItemRegistration {
+  id: string;
+  title: string;
+  icon?: string;
+  priority?: number;
+  permissions?: string | string[];
+  routeId?: string;
+  url?: string;
+  group?: string;
+  children?: MenuItemRegistration[];
+}
+
+/**
+ * Type for toolbar item registration
+ */
+export interface ToolbarItemRegistration {
+  id: string;
+  title: string;
+  icon?: string;
+  order?: number;
+  disabled?: boolean;
+  clickHandler?: () => void;
+  permissions?: string | string[];
+}

package/core/types/shell-feature.ts

@@ -0,0 +1,44 @@
+import type { Ref } from "vue";
+import type { Router, RouteLocationNormalizedLoaded } from "vue-router";
+import type { registerAppBarWidgetOptions } from "../services/app-bar-menu-service";
+import type { RegisterSettingsMenuItemOptions } from "../services/settings-menu-service";
+import type { AppBarButtonContent } from "../services/app-bar-mobile-buttons-service";
+
+/**
+ * Context provided to ShellFeature.onSetup callbacks.
+ */
+export interface ShellContext {
+  router: Router;
+  route: RouteLocationNormalizedLoaded;
+  isAuthenticated: Ref<boolean>;
+  isEmbedded: boolean;
+}
+
+/**
+ * A ShellFeature is a declarative configuration object that registers
+ * widgets, menu items, and buttons into the shell at setup time.
+ *
+ * Consumer apps can compose features to customize the shell:
+ * ```ts
+ * const features = [
+ *   ...defaultFeatures.filter(f => f.id !== "notifications"),
+ *   myCustomFeature,
+ * ];
+ * ```
+ */
+export interface ShellFeature {
+  /** Unique identifier for this feature */
+  id: string;
+
+  /** Widgets shown in the app bar toolbar (e.g., notification bell) */
+  appBarWidgets?: registerAppBarWidgetOptions[];
+
+  /** Items in the settings/user dropdown (e.g., language, theme, logout) */
+  settingsMenuItems?: RegisterSettingsMenuItemOptions[];
+
+  /** Buttons shown on the mobile app bar */
+  mobileButtons?: AppBarButtonContent[];
+
+  /** Called after all services are provided, before app renders */
+  onSetup?: (context: ShellContext) => void;
+}

package/core/utilities/errorTypes.ts

@@ -0,0 +1,126 @@
+/**
+ * Base error class for VC-Shell framework
+ * Provides structured error handling with error codes and context
+ */
+export class FrameworkError extends Error {
+  constructor(
+    message: string,
+    public readonly code: string,
+    public readonly context?: Record<string, unknown>,
+  ) {
+    super(message);
+    this.name = "FrameworkError";
+
+    // Maintains proper stack trace for where our error was thrown (only available on V8)
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, FrameworkError);
+    }
+  }
+
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      context: this.context,
+      stack: this.stack,
+    };
+  }
+}
+
+/**
+ * Error thrown when validation fails
+ */
+export class ValidationError extends FrameworkError {
+  constructor(message: string, context?: Record<string, unknown>) {
+    super(message, "VALIDATION_ERROR", context);
+    this.name = "ValidationError";
+  }
+}
+
+/**
+ * Error thrown when a service operation fails
+ */
+export class ServiceError extends FrameworkError {
+  constructor(message: string, context?: Record<string, unknown>) {
+    super(message, "SERVICE_ERROR", context);
+    this.name = "ServiceError";
+  }
+}
+
+/**
+ * Error thrown when a required dependency is not provided
+ */
+export class InjectionError extends FrameworkError {
+  constructor(serviceName: string, context?: Record<string, unknown>) {
+    super(`${serviceName} not provided. Make sure to call the corresponding 'provide' function.`, "INJECTION_ERROR", {
+      serviceName,
+      ...context,
+    });
+    this.name = "InjectionError";
+  }
+}
+
+/**
+ * Error thrown when component registration fails
+ */
+export class RegistrationError extends FrameworkError {
+  constructor(componentName: string, reason: string, context?: Record<string, unknown>) {
+    super(`Failed to register '${componentName}': ${reason}`, "REGISTRATION_ERROR", {
+      componentName,
+      ...context,
+    });
+    this.name = "RegistrationError";
+  }
+}
+
+/**
+ * Error thrown when a blade operation fails
+ */
+export class BladeError extends FrameworkError {
+  constructor(message: string, bladeId?: string, context?: Record<string, unknown>) {
+    super(message, "BLADE_ERROR", {
+      bladeId,
+      ...context,
+    });
+    this.name = "BladeError";
+  }
+}
+
+/**
+ * Error thrown when module loading fails
+ */
+export class ModuleLoadError extends FrameworkError {
+  constructor(moduleId: string, reason: string, context?: Record<string, unknown>) {
+    super(`Failed to load module '${moduleId}': ${reason}`, "MODULE_LOAD_ERROR", {
+      moduleId,
+      ...context,
+    });
+    this.name = "ModuleLoadError";
+  }
+}
+
+/**
+ * Type guard to check if an error is a FrameworkError
+ */
+export function isFrameworkError(error: unknown): error is FrameworkError {
+  return error instanceof FrameworkError;
+}
+
+/**
+ * Wraps an unknown error into a FrameworkError
+ */
+export function wrapError(error: unknown, code = "UNKNOWN_ERROR"): FrameworkError {
+  if (isFrameworkError(error)) {
+    return error;
+  }
+
+  if (error instanceof Error) {
+    return new FrameworkError(error.message, code, {
+      originalError: error.name,
+      stack: error.stack,
+    });
+  }
+
+  return new FrameworkError(String(error), code);
+}

package/core/utilities/index.ts

@@ -2,3 +2,5 @@ export * from "./camelToSnake";
 export * from "./kebabToCamel";
 export * from "./camelize";
 export * from "./generateId";
+export * from "./logger";
+export * from "./errorTypes";

package/core/utilities/logger.ts

@@ -0,0 +1,120 @@
+/**
+ * Logger utility for consistent logging throughout the framework.
+ * Provides conditional logging based on environment and log levels.
+ */
+
+export type LogLevel = "debug" | "info" | "warn" | "error" | "none";
+
+interface LoggerConfig {
+  level: LogLevel;
+  prefix: string;
+  enabled: boolean;
+}
+
+const LOG_LEVELS: Record<LogLevel, number> = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  none: 4,
+};
+
+/**
+ * Default configuration - can be overridden per logger instance
+ */
+const defaultConfig: LoggerConfig = {
+  level: (import.meta.env?.DEV ? "debug" : "warn") as LogLevel,
+  prefix: "@vc-shell/framework",
+  enabled: true,
+};
+
+/**
+ * Creates a logger instance with optional context prefix
+ * @param context - Additional context prefix for log messages
+ * @returns Logger instance with log methods
+ */
+export function createLogger(context?: string) {
+  const config = { ...defaultConfig };
+  const prefix = context ? `[${config.prefix}#${context}]` : `[${config.prefix}]`;
+
+  const shouldLog = (level: LogLevel): boolean => {
+    if (!config.enabled) return false;
+    return LOG_LEVELS[level] >= LOG_LEVELS[config.level];
+  };
+
+  return {
+    /**
+     * Log debug messages (only in development)
+     */
+    debug: (...args: unknown[]): void => {
+      if (shouldLog("debug")) {
+        console.debug(prefix, ...args);
+      }
+    },
+
+    /**
+     * Log info messages
+     */
+    info: (...args: unknown[]): void => {
+      if (shouldLog("info")) {
+        console.info(prefix, ...args);
+      }
+    },
+
+    /**
+     * Log warning messages
+     */
+    warn: (...args: unknown[]): void => {
+      if (shouldLog("warn")) {
+        console.warn(prefix, ...args);
+      }
+    },
+
+    /**
+     * Log error messages
+     */
+    error: (...args: unknown[]): void => {
+      if (shouldLog("error")) {
+        console.error(prefix, ...args);
+      }
+    },
+
+    /**
+     * Create a child logger with additional context
+     */
+    child: (childContext: string) => {
+      return createLogger(context ? `${context}:${childContext}` : childContext);
+    },
+
+    /**
+     * Set the log level for this logger instance
+     */
+    setLevel: (level: LogLevel): void => {
+      config.level = level;
+    },
+
+    /**
+     * Enable or disable logging
+     */
+    setEnabled: (enabled: boolean): void => {
+      config.enabled = enabled;
+    },
+  };
+}
+
+/**
+ * Default logger instance for general framework logging
+ */
+export const logger = createLogger();
+
+/**
+ * Pre-configured loggers for common contexts
+ */
+export const loggers = {
+  core: createLogger("core"),
+  ui: createLogger("ui"),
+  shared: createLogger("shared"),
+  plugins: createLogger("plugins"),
+  services: createLogger("services"),
+  composables: createLogger("composables"),
+};

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":"AAIA,wBAAgB,iCAAiC,yDAIhD;AAED,wBAAgB,sBAAsB,yDAMrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppBarMobileButtons/index.ts"],"names":[],"mappings":"AAOA,wBAAgB,iCAAiC,yDAShD;AAED,wBAAgB,sBAAsB,yDAOrC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppBarWidget/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAA6B,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAGvH,wBAAgB,mBAAmB,IAAI,oBAAoB,CAI1D;AAED,wBAAgB,eAAe,IAAI,oBAAoB,CAMtD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppBarWidget/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EAEf,oBAAoB,EAErB,MAAM,qCAAqC,CAAC;AAM7C,wBAAgB,mBAAmB,IAAI,oBAAoB,CAc1D;AAED,wBAAgB,eAAe,IAAI,oBAAoB,CAOtD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAppBarWidget/index.test.ts"],"names":[],"mappings":""}

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,EAAsB,WAAW,EAAE,MAAM,KAAK,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,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,wBAAgB,SAAS,IAAI,UAAU,CAkFtC"}
+{"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,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,MAAM,WAAW,UAAU;IACzB,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;AAwDD,wBAAgB,SAAS,IAAI,UAAU,CAwEtC"}

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":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,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,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAE,SAAQ,UAAU;IACzE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EACpD,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAmB3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useAsync/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAK3C,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,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAE,SAAQ,UAAU;IACzE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EACpD,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAmB3B"}

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

@@ -1,6 +1,45 @@
+import type { BladeOpenEvent } from "../../../shared/components/blade-navigation/types";
 /**
- * Composable for accessing the current blade instance
- * @returns The current blade instance
+ * Composable for accessing the current blade instance (legacy API).
+ *
+ * Returns a ComputedRef<IBladeInstance> — the same type as before.
+ * For the new extended API with actions (openBlade, closeSelf, etc.),
+ * use `useBladeContext()` instead.
+ *
+ * @returns The current blade instance (ComputedRef)
  */
 export declare function useBlade(): import("vue").ComputedRef<import("../../..").IBladeInstance>;
+/**
+ * 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).
+ *
+ * @example
+ * ```ts
+ * const { param, options, openBlade, closeSelf, callParent } = useBladeContext();
+ * openBlade({ name: "OrderDetails", param: orderId });
+ * const result = await callParent("reload");
+ * closeSelf();
+ * ```
+ */
+export declare function useBladeContext(): {
+    id: import("vue").ComputedRef<string>;
+    param: import("vue").ComputedRef<string | undefined>;
+    options: import("vue").ComputedRef<Record<string, unknown> | undefined>;
+    query: import("vue").ComputedRef<Record<string, string> | undefined>;
+    closable: import("vue").ComputedRef<boolean>;
+    expanded: import("vue").ComputedRef<boolean>;
+    openBlade: (event: BladeOpenEvent) => Promise<void>;
+    closeSelf: () => Promise<boolean>;
+    replaceWith: (event: BladeOpenEvent) => Promise<void>;
+    callParent: <T = unknown>(method: string, args?: unknown) => Promise<T>;
+    exposeToChildren: (methods: Record<string, (...args: any[]) => any>) => void;
+    onBeforeClose: (guard: () => Promise<boolean>) => void;
+    setError: (error: unknown) => void;
+    clearError: () => void;
+};
 //# 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":"AAGA;;;GAGG;AACH,wBAAgB,QAAQ,iEAOvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBlade/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAER,cAAc,EAGjB,MAAM,mDAAmD,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,iEAOvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe;;;;;;;uBA8BK,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC;qBAOlC,OAAO,CAAC,OAAO,CAAC;yBAIV,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC;iBAStC,CAAC,oBAAoB,MAAM,SAAS,OAAO,KAAG,OAAO,CAAC,CAAC,CAAC;gCAI/C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,KAAG,IAAI;2BAMnD,MAAM,OAAO,CAAC,OAAO,CAAC,KAAG,IAAI;sBAMlC,OAAO,KAAG,IAAI;sBAIhB,IAAI;EA6B9B"}

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

@@ -7,6 +7,7 @@ export interface IBladeRegistrationData {
     component: BladeInstanceConstructor;
     route?: string;
     isWorkspace?: boolean;
+    routable?: boolean;
 }
 /**
  * Injection key for provide/inject pattern
@@ -22,12 +23,17 @@ export interface IBladeRegistry {
     getBlade: (name: string) => IBladeRegistrationData | undefined;
     /** Get blade component by name */
     getBladeComponent: (name: string) => BladeInstanceConstructor | undefined;
+    /** Reverse lookup: find blade name + data by URL route segment (O(1)) */
+    getBladeByRoute: (route: string) => {
+        name: string;
+        data: IBladeRegistrationData;
+    } | undefined;
 }
 /**
  * Extended interface for blade registry instance with internal registration function
  */
 export interface IBladeRegistryInstance extends IBladeRegistry {
-    _registerBladeFn: (name: string, registrationData: IBladeRegistrationData) => void;
+    _registerBladeFn: (name: string, registrationData: IBladeRegistrationData, allowOverwrite?: boolean) => void;
 }
 /**
  * Creates a blade registry instance

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,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,wBAAwB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CAEvB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA0B,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,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;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACpF;AAeD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,sBAAsB,CAqGpE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAQjD"}
+{"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,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAK7F;;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;CAEpB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA0B,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,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;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,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,CAsJpE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAQjD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBladeRegistry/index.test.ts"],"names":[],"mappings":""}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBreadcrumbs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAA+B,MAAM,KAAK,CAAC;AAQ/D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACjC;AAED,wBAAgB,cAAc;;uBAmBF,WAAW;kBAgChB,MAAM,EAAE;EAc9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useBreadcrumbs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAA+B,MAAM,KAAK,CAAC;AAW/D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACjC;AAED,wBAAgB,cAAc;;uBAmBF,WAAW;kBAgChB,MAAM,EAAE;EAc9B"}