@vc-shell/framework 1.2.4-beta.7 → 2.0.0-alpha.0

package/core/services/app-bar-settings-service.test.ts

@@ -1,153 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-
-async function loadAppBarMenuServiceModule() {
-  vi.resetModules();
-  return import("@core/services/app-bar-menu-service");
-}
-
-async function loadSettingsMenuServiceModule() {
-  vi.resetModules();
-  return import("@core/services/settings-menu-service");
-}
-
-describe("app-bar-menu-service", () => {
-  it("keeps widget collections isolated across service instances", async () => {
-    const { createAppBarWidgetService } = await loadAppBarMenuServiceModule();
-    const firstService = createAppBarWidgetService();
-    const secondService = createAppBarWidgetService();
-
-    firstService.register({ id: "widget-1", icon: "material-home" });
-
-    expect(firstService.items.value).toHaveLength(1);
-    expect(secondService.items.value).toHaveLength(0);
-  });
-
-  it("registers and unregisters widgets", async () => {
-    const { createAppBarWidgetService } = await loadAppBarMenuServiceModule();
-    const service = createAppBarWidgetService();
-
-    const id = service.register({ id: "w1", icon: "icon-1" });
-    expect(service.items.value).toHaveLength(1);
-
-    service.unregister(id);
-    expect(service.items.value).toHaveLength(0);
-  });
-
-  it("sorts items by order", async () => {
-    const { createAppBarWidgetService } = await loadAppBarMenuServiceModule();
-    const service = createAppBarWidgetService();
-
-    service.register({ id: "b", order: 2, icon: "icon-b" });
-    service.register({ id: "a", order: 1, icon: "icon-a" });
-    service.register({ id: "c", order: 3, icon: "icon-c" });
-
-    expect(service.items.value.map((i) => i.id)).toEqual(["a", "b", "c"]);
-  });
-
-  it("auto-generates id if not provided", async () => {
-    const { createAppBarWidgetService } = await loadAppBarMenuServiceModule();
-    const service = createAppBarWidgetService();
-
-    const id = service.register({ icon: "icon-1" });
-    expect(id).toBeTruthy();
-    expect(service.items.value).toHaveLength(1);
-  });
-
-  it("stores widget title and search terms", async () => {
-    const { createAppBarWidgetService } = await loadAppBarMenuServiceModule();
-    const service = createAppBarWidgetService();
-
-    service.register({
-      id: "notifications",
-      icon: "lucide-bell",
-      title: "Notifications",
-      searchTerms: ["alerts", "inbox"],
-    });
-
-    expect(service.items.value[0].title).toBe("Notifications");
-    expect(service.items.value[0].searchTerms).toEqual(["alerts", "inbox"]);
-  });
-
-  it("preregistration deduplicates items with same id", async () => {
-    const { addAppBarWidget, createAppBarWidgetService } = await loadAppBarMenuServiceModule();
-
-    addAppBarWidget({ id: "pre-widget", icon: "v1" });
-    addAppBarWidget({ id: "pre-widget", icon: "v2" });
-
-    const service = createAppBarWidgetService();
-    expect(service.items.value).toHaveLength(1);
-    expect(service.items.value[0].icon).toBe("v2");
-  });
-
-  it("live-broadcasts to existing services when preregistering", async () => {
-    const { addAppBarWidget, createAppBarWidgetService } = await loadAppBarMenuServiceModule();
-
-    const service = createAppBarWidgetService();
-    addAppBarWidget({ id: "late-widget", icon: "late-icon" });
-
-    expect(service.items.value).toHaveLength(1);
-  });
-
-  it("disposes service instance via bus", async () => {
-    const { createAppBarWidgetService, appBarWidgetBus } = await loadAppBarMenuServiceModule();
-    const service = createAppBarWidgetService();
-
-    expect(appBarWidgetBus.instanceCount).toBe(1);
-    appBarWidgetBus.dispose(service);
-    expect(appBarWidgetBus.instanceCount).toBe(0);
-  });
-});
-
-describe("settings-menu-service", () => {
-  it("keeps menu items isolated across service instances", async () => {
-    const { createSettingsMenuService } = await loadSettingsMenuServiceModule();
-    const firstService = createSettingsMenuService();
-    const secondService = createSettingsMenuService();
-
-    firstService.register({ id: "settings-1", component: {} as any });
-
-    expect(firstService.items.value).toHaveLength(1);
-    expect(secondService.items.value).toHaveLength(0);
-  });
-
-  it("registers and unregisters items", async () => {
-    const { createSettingsMenuService } = await loadSettingsMenuServiceModule();
-    const service = createSettingsMenuService();
-
-    const id = service.register({ id: "s1", component: {} as any });
-    expect(service.items.value).toHaveLength(1);
-
-    service.unregister(id);
-    expect(service.items.value).toHaveLength(0);
-  });
-
-  it("sorts items by order", async () => {
-    const { createSettingsMenuService } = await loadSettingsMenuServiceModule();
-    const service = createSettingsMenuService();
-
-    service.register({ id: "b", order: 2, component: {} as any });
-    service.register({ id: "a", order: 1, component: {} as any });
-
-    expect(service.items.value.map((i) => i.id)).toEqual(["a", "b"]);
-  });
-
-  it("preregistration deduplicates items with same id", async () => {
-    const { addSettingsMenuItem, createSettingsMenuService } = await loadSettingsMenuServiceModule();
-
-    addSettingsMenuItem({ id: "pre-s", component: {} as any, order: 1 });
-    addSettingsMenuItem({ id: "pre-s", component: {} as any, order: 2 });
-
-    const service = createSettingsMenuService();
-    expect(service.items.value).toHaveLength(1);
-    expect(service.items.value[0].order).toBe(2);
-  });
-
-  it("disposes service instance via bus", async () => {
-    const { createSettingsMenuService, settingsMenuBus } = await loadSettingsMenuServiceModule();
-    const service = createSettingsMenuService();
-
-    expect(settingsMenuBus.instanceCount).toBe(1);
-    settingsMenuBus.dispose(service);
-    expect(settingsMenuBus.instanceCount).toBe(0);
-  });
-});

package/core/services/dashboard-service.ts

@@ -1,110 +0,0 @@
-import { reactive, Component } from "vue";
-import { createPreregistrationBus } from "@core/services/_internal";
-
-export interface DashboardWidgetSize {
-  width: number;
-  height: number;
-}
-
-export interface DashboardWidgetPosition {
-  x: number;
-  y: number;
-}
-
-export interface DashboardWidget {
-  id: string;
-  name: string;
-  component: Component;
-  size: DashboardWidgetSize;
-  position?: DashboardWidgetPosition;
-  permissions?: string[];
-  props?: Record<string, unknown>;
-}
-
-export interface IDashboardService {
-  registerWidget: (widget: DashboardWidget) => void;
-  getWidgets: () => DashboardWidget[];
-  updateWidgetPosition: (widgetId: string, position: DashboardWidgetPosition) => void;
-  getLayout: () => ReadonlyMap<string, DashboardWidgetPosition>;
-}
-
-export interface CreateDashboardServiceOptions {
-  hasAccess?: (permissions: string[] | undefined) => boolean;
-}
-
-export const dashboardBus = createPreregistrationBus<DashboardWidget, IDashboardService>({
-  name: "dashboard-service",
-  getKey: (widget) => widget.id,
-  registerIntoService: (service, widget) => service.registerWidget(widget),
-});
-
-/**
- * Registers a widget before the service is initialized.
- */
-export function registerDashboardWidget(widget: DashboardWidget): void {
-  dashboardBus.preregister(widget);
-}
-
-const createState = () => ({
-  widgets: reactive<Map<string, DashboardWidget>>(new Map()),
-  layout: reactive<Map<string, DashboardWidgetPosition>>(new Map()),
-});
-
-/**
- * Creates a service for managing dashboard widgets.
- */
-export function createDashboardService(options: CreateDashboardServiceOptions = {}): IDashboardService {
-  const state = createState();
-  const hasAccess = options.hasAccess ?? (() => true);
-
-  const registerWidget = (widget: DashboardWidget): void => {
-    if (state.widgets.has(widget.id)) {
-      throw new Error(`Widget with id ${widget.id} already registered`);
-    }
-
-    state.widgets.set(widget.id, {
-      ...widget,
-      permissions: widget.permissions ? [...widget.permissions] : undefined,
-      position: widget.position ? { ...widget.position } : undefined,
-      props: widget.props ? { ...widget.props } : undefined,
-    });
-
-    if (widget.position) {
-      state.layout.set(widget.id, { ...widget.position });
-    }
-  };
-
-  const getWidgets = (): DashboardWidget[] => {
-    return Array.from(state.widgets.values())
-      .filter((widget) => !widget.permissions || widget.permissions.length === 0 || hasAccess(widget.permissions))
-      .map((widget) => ({
-        ...widget,
-        permissions: widget.permissions ? [...widget.permissions] : undefined,
-        position: widget.position ? { ...widget.position } : undefined,
-        props: widget.props ? { ...widget.props } : undefined,
-      }));
-  };
-
-  const updateWidgetPosition = (widgetId: string, position: DashboardWidgetPosition): void => {
-    if (!state.widgets.has(widgetId)) {
-      throw new Error(`Widget with id ${widgetId} not found`);
-    }
-
-    state.layout.set(widgetId, { ...position });
-  };
-
-  const getLayout = (): ReadonlyMap<string, DashboardWidgetPosition> => {
-    return new Map(state.layout);
-  };
-
-  const service: IDashboardService = {
-    registerWidget,
-    getWidgets,
-    updateWidgetPosition,
-    getLayout,
-  };
-
-  dashboardBus.replayInto(service);
-
-  return service;
-}

package/core/services/global-search-service/global-search-service.md

@@ -1,28 +0,0 @@
-# Global Search Service
-
-## Purpose
-`createGlobalSearchService` keeps search visibility state and search query text per blade.
-
-## Source
-`framework/core/services/global-search-service/index.ts`
-
-## API
-
-```ts
-interface GlobalSearchState {
-  isSearchVisible: Ref<Record<string, boolean>>;
-  searchQuery: Ref<Record<string, string>>;
-  toggleSearch(bladeId: string): void;
-  setSearchQuery(bladeId: string, query: string): void;
-  closeSearch(bladeId: string): void;
-}
-```
-
-## Behavior
-- State is scoped to a service instance.
-- `toggleSearch` flips visibility for a blade key.
-- `closeSearch` always sets visibility to `false`.
-- `setSearchQuery` updates the per-blade query string.
-
-## Usage
-Use via `useGlobalSearch` / `provideGlobalSearch` composables.

package/core/services/global-search-service/index.ts

@@ -1,36 +0,0 @@
-import { Ref, ref } from "vue";
-
-export interface GlobalSearchState {
-  isSearchVisible: Ref<Record<string, boolean>>;
-  searchQuery: Ref<Record<string, string>>;
-  toggleSearch: (bladeId: string) => void;
-  setSearchQuery: (bladeId: string, query: string) => void;
-  closeSearch: (bladeId: string) => void;
-}
-
-export function createGlobalSearchService() {
-  const isSearchVisible = ref<Record<string, boolean>>({});
-  const searchQuery = ref<Record<string, string>>({});
-
-  const toggleSearch = (bladeId: string) => {
-    isSearchVisible.value[bladeId] = !isSearchVisible.value[bladeId];
-  };
-
-  const setSearchQuery = (bladeId: string, query: string) => {
-    searchQuery.value[bladeId] = query;
-  };
-
-  const closeSearch = (bladeId: string) => {
-    isSearchVisible.value[bladeId] = false;
-  };
-
-  const state: GlobalSearchState = {
-    isSearchVisible,
-    searchQuery,
-    toggleSearch,
-    setSearchQuery,
-    closeSearch,
-  };
-
-  return state;
-}

package/core/services/index.ts

@@ -1,11 +0,0 @@
-export * from "@core/services/app-bar-menu-service";
-export * from "@core/services/app-bar-mobile-buttons-service";
-export * from "@core/services/dashboard-service";
-export * from "@core/services/global-search-service";
-export * from "@core/services/language-service";
-export * from "@core/services/menu-service";
-export * from "@core/services/settings-menu-service";
-export * from "@core/services/toolbar-service";
-export * from "@core/services/widget-service";
-// blade-selection-service and ai-agent-service are now part of the ai-agent plugin
-// export * from "./core/plugins/ai-agent";

package/core/services/language-dashboard-service.test.ts

@@ -1,183 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-
-async function loadLanguageServiceModule() {
-  vi.resetModules();
-  return import("@core/services/language-service");
-}
-
-async function loadDashboardServiceModule() {
-  vi.resetModules();
-  return import("@core/services/dashboard-service");
-}
-
-describe("language-service", () => {
-  it("resolves unknown locales to 'en'", async () => {
-    const { createLanguageService } = await loadLanguageServiceModule();
-    localStorage.removeItem("VC_LANGUAGE_SETTINGS");
-    const service = createLanguageService();
-
-    expect(service.resolveCamelCaseLocale("zzZZ")).toBe("en");
-  });
-
-  it("falls back to a supported locale in setLocale", async () => {
-    const { createLanguageService } = await loadLanguageServiceModule();
-    localStorage.removeItem("VC_LANGUAGE_SETTINGS");
-    const service = createLanguageService();
-
-    service.setLocale("zzZZ");
-
-    expect(service.currentLocale.value).toBe("en");
-  });
-});
-
-describe("dashboard-service", () => {
-  it("works without implicit composable dependencies and supports injected access checks", async () => {
-    const { createDashboardService } = await loadDashboardServiceModule();
-
-    const permissiveService = createDashboardService();
-    permissiveService.registerWidget({
-      id: "widget-1",
-      name: "Widget 1",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-      permissions: ["can-read"],
-    });
-
-    expect(permissiveService.getWidgets()).toHaveLength(1);
-
-    const restrictiveService = createDashboardService({ hasAccess: () => false });
-    restrictiveService.registerWidget({
-      id: "widget-2",
-      name: "Widget 2",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-      permissions: ["can-read"],
-    });
-
-    expect(restrictiveService.getWidgets()).toHaveLength(0);
-  });
-
-  it("returns a copy of layout map from getLayout", async () => {
-    const { createDashboardService } = await loadDashboardServiceModule();
-    const service = createDashboardService();
-
-    service.registerWidget({
-      id: "widget-1",
-      name: "Widget 1",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-      position: { x: 0, y: 0 },
-    });
-
-    const layout = service.getLayout() as Map<string, { x: number; y: number }>;
-    layout.set("external-mutation", { x: 100, y: 100 });
-
-    expect(service.getLayout().has("external-mutation")).toBe(false);
-  });
-
-  it("throws on duplicate widget ID", async () => {
-    const { createDashboardService } = await loadDashboardServiceModule();
-    const service = createDashboardService();
-
-    service.registerWidget({
-      id: "dup",
-      name: "First",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-    });
-
-    expect(() =>
-      service.registerWidget({
-        id: "dup",
-        name: "Second",
-        component: {} as any,
-        size: { width: 1, height: 1 },
-      }),
-    ).toThrow("Widget with id dup already registered");
-  });
-
-  it("updates widget position", async () => {
-    const { createDashboardService } = await loadDashboardServiceModule();
-    const service = createDashboardService();
-
-    service.registerWidget({
-      id: "w1",
-      name: "Widget",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-      position: { x: 0, y: 0 },
-    });
-
-    service.updateWidgetPosition("w1", { x: 5, y: 10 });
-    const layout = service.getLayout();
-    expect(layout.get("w1")).toEqual({ x: 5, y: 10 });
-  });
-
-  it("throws on updating position for non-existent widget", async () => {
-    const { createDashboardService } = await loadDashboardServiceModule();
-    const service = createDashboardService();
-
-    expect(() => service.updateWidgetPosition("nonexistent", { x: 0, y: 0 })).toThrow(
-      "Widget with id nonexistent not found",
-    );
-  });
-
-  it("preregistration deduplicates by widget id", async () => {
-    const { registerDashboardWidget, createDashboardService } = await loadDashboardServiceModule();
-
-    registerDashboardWidget({
-      id: "pre-w",
-      name: "V1",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-    });
-    registerDashboardWidget({
-      id: "pre-w",
-      name: "V2",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-    });
-
-    const service = createDashboardService();
-    // Bus deduplicates preregistered items, so only V2 is replayed
-    expect(service.getWidgets()).toHaveLength(1);
-    expect(service.getWidgets()[0].name).toBe("V2");
-  });
-
-  it("disposes service instance via bus", async () => {
-    const { createDashboardService, dashboardBus } = await loadDashboardServiceModule();
-    const service = createDashboardService();
-
-    expect(dashboardBus.instanceCount).toBe(1);
-    dashboardBus.dispose(service);
-    expect(dashboardBus.instanceCount).toBe(0);
-  });
-
-  it("filters widgets by permissions", async () => {
-    const { createDashboardService } = await loadDashboardServiceModule();
-
-    const service = createDashboardService({
-      hasAccess: (perms) => perms?.includes("admin") ?? false,
-    });
-
-    service.registerWidget({
-      id: "admin-widget",
-      name: "Admin Only",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-      permissions: ["admin"],
-    });
-
-    service.registerWidget({
-      id: "public-widget",
-      name: "Public",
-      component: {} as any,
-      size: { width: 1, height: 1 },
-    });
-
-    const widgets = service.getWidgets();
-    expect(widgets).toHaveLength(2);
-    expect(widgets.map((w) => w.id)).toContain("admin-widget");
-    expect(widgets.map((w) => w.id)).toContain("public-widget");
-  });
-});

package/core/services/language-service.ts

@@ -1,98 +0,0 @@
-import * as veeValidate from "vee-validate";
-import { i18n } from "@core/plugins/i18n";
-import { setLocale as setVeeI18nLocale, localize } from "@vee-validate/i18n";
-import { useLocalStorage } from "@vueuse/core";
-import { ComputedRef, computed } from "vue";
-import ISO6391 from "iso-639-1";
-import { languageToCountryMap } from "@core/constants";
-
-export interface ILanguageService {
-  setLocale: (locale: string) => void;
-  currentLocale: ComputedRef<string>;
-  getLocaleByTag: (localeTag: string) => string | undefined;
-  resolveCamelCaseLocale: (locale: string) => string;
-  getFlag: (language: string) => Promise<string>;
-  getCountryCode: (language: string) => string;
-}
-
-/**
- * Language service implementation
- * Handles locale management, validation, and language utilities
- */
-export function createLanguageService(): ILanguageService {
-  const savedLocale = useLocalStorage("VC_LANGUAGE_SETTINGS", "");
-
-  function resolveSupportedLocale(locale: string): string {
-    if (!locale) {
-      return "en";
-    }
-
-    const normalizedLocale = locale.replace(/([a-z]+)([A-Z]+)/g, "$1-$2").toLowerCase();
-    return i18n.global.availableLocales.includes(normalizedLocale) ? normalizedLocale : "en";
-  }
-
-  // Initialize locale from localStorage on service creation
-  if (savedLocale.value && i18n.global.availableLocales.includes(savedLocale.value)) {
-    i18n.global.locale.value = savedLocale.value;
-  }
-
-  const currentLocale = computed(() => {
-    if (i18n.global.availableLocales.includes(savedLocale.value)) {
-      return savedLocale.value;
-    }
-
-    return i18n.global.locale.value;
-  });
-
-  function setLocale(locale: string) {
-    const resolvedLocale = resolveSupportedLocale(locale);
-
-    // Update the global i18n locale
-    i18n.global.locale.value = resolvedLocale;
-
-    const localeMessages = (i18n.global.getLocaleMessage(resolvedLocale) as { messages?: Record<string, string> })
-      ?.messages;
-
-    veeValidate.configure({
-      generateMessage: localize(resolvedLocale, {
-        messages: localeMessages ?? {},
-      }),
-    });
-
-    setVeeI18nLocale(resolvedLocale);
-    savedLocale.value = resolvedLocale;
-  }
-
-  function getLocaleByTag(localeTag: string) {
-    if (!localeTag) return;
-
-    const twoLetterLanguageName = localeTag.split("-")[0];
-
-    return ISO6391.getNativeName(twoLetterLanguageName);
-  }
-
-  function resolveCamelCaseLocale(locale: string) {
-    return resolveSupportedLocale(locale);
-  }
-
-  function getCountryCode(language: string): string {
-    return (
-      languageToCountryMap[language.toLowerCase()] || languageToCountryMap[language.slice(0, 2)] || "xx" // placeholder for unknown country
-    );
-  }
-
-  async function getFlag(language: string): Promise<string> {
-    if (!language) return "";
-    const countryCode = getCountryCode(language);
-    return new URL(`../../assets/icons/flags/${countryCode}.svg`, import.meta.url).href;
-  }
-
-  return {
-    setLocale,
-    currentLocale,
-    getLocaleByTag,
-    resolveCamelCaseLocale,
-    getFlag,
-    getCountryCode,
-  };
-}