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

package/core/composables/useUserManagement/index.ts

@@ -1,45 +0,0 @@
-import { computed, ComputedRef } from "vue";
-import { createSharedComposable } from "@vueuse/core";
-import { _createInternalUserLogic, IUserInternalAPI } from "@core/composables/useUser"; // Import the internal logic
-import { SecurityResult, IdentityResult, LoginType, UserDetail, SignInResult } from "@core/api/platform";
-import type { RequestPasswordResult } from "@core/types";
-
-// Interface for the API exposed by useUserManagement (for framework/admin use)
-export interface IUserManagementAPI {
-  user: ComputedRef<UserDetail | undefined>;
-  loading: ComputedRef<boolean>;
-  isAdministrator: ComputedRef<boolean | undefined>;
-  isAuthenticated: ComputedRef<boolean>;
-  // Methods specific to user management
-  validateToken: (userId: string, token: string) => Promise<boolean>;
-  validatePassword: (password: string) => Promise<IdentityResult>;
-  resetPasswordByToken: (userId: string, password: string, token: string) => Promise<SecurityResult>;
-  getLoginType: () => Promise<LoginType[]>;
-  loadUser: () => Promise<UserDetail>;
-  requestPasswordReset: (loginOrEmail: string) => Promise<RequestPasswordResult>;
-  changeUserPassword: (oldPassword: string, newPassword: string) => Promise<SecurityResult | undefined>;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  signIn: (username: string, password: string) => Promise<SignInResult | { succeeded: boolean; error?: any }>;
-  signOut: () => Promise<void>;
-}
-
-export const useUserManagement = createSharedComposable((): IUserManagementAPI => {
-  // Utilize the same internal logic instance
-  const internals: IUserInternalAPI = _createInternalUserLogic();
-
-  return {
-    user: internals.user,
-    loading: internals.loading,
-    isAdministrator: internals.isAdministrator,
-    isAuthenticated: internals.isAuthenticated,
-    validateToken: internals.validateToken,
-    validatePassword: internals.validatePassword,
-    resetPasswordByToken: internals.resetPasswordByToken,
-    getLoginType: internals.getLoginType,
-    loadUser: internals.loadUser,
-    requestPasswordReset: internals.requestPasswordReset,
-    changeUserPassword: internals.changeUserPassword,
-    signIn: internals.signIn,
-    signOut: internals.signOut,
-  };
-});

package/core/composables/useWebVitals/index.ts

@@ -1,40 +0,0 @@
-import { onFCP, onLCP, onCLS, onINP, onTTFB } from "web-vitals";
-import type { Metric } from "web-vitals";
-
-export interface IWebVitalsMetric {
-  name: string;
-  value: number;
-  rating: "good" | "needs-improvement" | "poor";
-}
-
-export type WebVitalsCallback = (metric: IWebVitalsMetric) => void;
-
-/**
- * Registers Core Web Vitals observers (FCP, LCP, CLS, INP, TTFB).
- * Call once per app session, typically after app.mount().
- *
- * @param callback - Optional custom handler. Defaults to console.warn in dev mode.
- */
-export function useWebVitals(callback?: WebVitalsCallback): void {
-  const defaultCallback: WebVitalsCallback = (metric) => {
-    if (import.meta.env.DEV) {
-      const unit = metric.name === "CLS" ? "" : "ms";
-      const value = metric.name === "CLS" ? metric.value.toFixed(4) : Math.round(metric.value);
-      console.warn(`[web-vitals] ${metric.name}: ${value}${unit} (${metric.rating})`);
-    }
-  };
-
-  const handler = (metric: Metric) => {
-    (callback ?? defaultCallback)({
-      name: metric.name,
-      value: metric.value,
-      rating: metric.rating,
-    });
-  };
-
-  onFCP(handler);
-  onLCP(handler);
-  onCLS(handler);
-  onINP(handler);
-  onTTFB(handler);
-}

package/core/composables/useWidgets/index.test.ts

@@ -1,86 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { defineComponent, h, inject } from "vue";
-import { mount } from "@vue/test-utils";
-import { WidgetServiceKey } from "@framework/injection-keys";
-import { provideWidgetService, useWidgets } from "@core/composables/useWidgets";
-import { createWidgetService } from "@core/services/widget-service";
-
-describe("useWidgets", () => {
-  it("throws InjectionError when no service is provided", () => {
-    const TestComp = defineComponent({
-      setup() {
-        expect(() => useWidgets()).toThrow("WidgetService");
-        return () => h("div");
-      },
-    });
-
-    mount(TestComp);
-  });
-
-  it("returns injected service", () => {
-    const service = createWidgetService();
-
-    const TestComp = defineComponent({
-      setup() {
-        const result = useWidgets();
-        expect(result).toBe(service);
-        return () => h("div");
-      },
-    });
-
-    mount(TestComp, {
-      global: {
-        provide: { [WidgetServiceKey as symbol]: service },
-      },
-    });
-  });
-});
-
-describe("provideWidgetService", () => {
-  it("creates and provides a service", () => {
-    let providedService: any;
-    let injectedService: any;
-
-    const Parent = defineComponent({
-      setup() {
-        providedService = provideWidgetService();
-        return () => h(Child);
-      },
-    });
-
-    const Child = defineComponent({
-      setup() {
-        injectedService = inject(WidgetServiceKey);
-        return () => h("div");
-      },
-    });
-
-    mount(Parent);
-
-    expect(providedService).toBeDefined();
-    expect(injectedService).toBe(providedService);
-  });
-
-  it("is idempotent — returns existing service if already provided", () => {
-    let firstResult: any;
-    let secondResult: any;
-
-    const GrandParent = defineComponent({
-      setup() {
-        firstResult = provideWidgetService();
-        return () => h(Parent);
-      },
-    });
-
-    const Parent = defineComponent({
-      setup() {
-        secondResult = provideWidgetService();
-        return () => h("div");
-      },
-    });
-
-    mount(GrandParent);
-
-    expect(firstResult).toBe(secondResult);
-  });
-});

package/core/composables/useWidgets/index.ts

@@ -1,39 +0,0 @@
-import { getCurrentInstance, inject, provide, getCurrentScope, onScopeDispose } from "vue";
-import {
-  createWidgetService,
-  IWidgetService,
-  registerWidget,
-  registerExternalWidget,
-  widgetBus,
-} from "@core/services/widget-service";
-import { WidgetServiceKey } from "@framework/injection-keys";
-import { createLogger, InjectionError } from "@core/utilities";
-
-const logger = createLogger("use-widgets");
-
-export function provideWidgetService(): IWidgetService {
-  const existingService = inject(WidgetServiceKey, null);
-  if (existingService) {
-    return existingService;
-  }
-
-  const service = createWidgetService();
-  provide(WidgetServiceKey, service);
-
-  if (getCurrentScope()) {
-    onScopeDispose(() => widgetBus.dispose(service));
-  }
-
-  return service;
-}
-
-export function useWidgets(): IWidgetService {
-  const service = inject(WidgetServiceKey);
-  if (!service) {
-    logger.error("Widget service not found in current context. Injection chain:", getCurrentInstance());
-    throw new InjectionError("WidgetService");
-  }
-  return service;
-}
-
-export { registerWidget, registerExternalWidget };

package/core/constants/defaults.ts

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

package/core/constants/index.ts

@@ -1,5 +0,0 @@
-export const FALLBACK_BLADE_ID = "fallback-blade-id";
-
-export * from "@core/constants/locale";
-export * from "@core/constants/ui";
-export * from "@core/constants/defaults";

package/core/constants/locale.ts

@@ -1,78 +0,0 @@
-/**
- * Mapping ISO 639-1 language codes (and culture codes) to ISO 3166-1 alpha-2 country codes
- * @see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
- * @see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
- */
-export const languageToCountryMap: Record<string, string> = {
-  af: "za",
-  ar: "sa",
-  az: "az",
-  be: "by",
-  bg: "bg",
-  bn: "bd",
-  bs: "ba",
-  ca: "es",
-  cs: "cz",
-  cy: "gb",
-  da: "dk",
-  de: "de",
-  el: "gr",
-  en: "us",
-  "en-gb": "gb",
-  es: "es",
-  et: "ee",
-  fa: "ir",
-  fi: "fi",
-  fil: "ph",
-  fr: "fr",
-  gu: "in",
-  he: "il",
-  hi: "in",
-  hr: "hr",
-  hu: "hu",
-  hy: "am",
-  id: "id",
-  is: "is",
-  it: "it",
-  ja: "jp",
-  ka: "ge",
-  kk: "kz",
-  km: "kh",
-  kn: "in",
-  ko: "kr",
-  ky: "kg",
-  lt: "lt",
-  lv: "lv",
-  mk: "mk",
-  ml: "in",
-  mn: "mn",
-  mr: "in",
-  ms: "my",
-  mt: "mt",
-  ne: "np",
-  nl: "nl",
-  no: "no",
-  pa: "in",
-  pl: "pl",
-  pt: "pt",
-  ro: "ro",
-  ru: "ru",
-  si: "lk",
-  sk: "sk",
-  sl: "si",
-  sq: "al",
-  sr: "rs",
-  sv: "se",
-  sw: "tz",
-  ta: "in",
-  te: "in",
-  th: "th",
-  tr: "tr",
-  uk: "ua",
-  ur: "pk",
-  uz: "uz",
-  vi: "vn",
-  yo: "ng",
-  zh: "cn",
-  zu: "za",
-};

package/core/constants/ui.ts

@@ -1,68 +0,0 @@
-/**
- * UI Constants for VC-Shell Framework
- * Centralized storage for magic numbers and UI-related constants
- */
-
-export const UI_CONSTANTS = {
-  // Grid system
-  GRID_COLUMNS: 12,
-  CELL_HEIGHT: 80,
-  WIDGET_GAP: 20,
-
-  // Timing (milliseconds)
-  DEBOUNCE_DEFAULT_MS: 500,
-  HOVER_DELAY_MS: 200,
-  TOOLTIP_DELAY_MS: 300,
-  RESIZE_DEBOUNCE_MS: 100,
-  ANIMATION_DURATION_MS: 200,
-  TRANSITION_DURATION_MS: 150,
-
-  // Thresholds
-  DRAG_THRESHOLD_PX: 3,
-  MAX_COLLISION_ITERATIONS: 50,
-  MIN_COLUMN_WIDTH_PX: 15,
-  OVERFLOW_THRESHOLD: 100,
-
-  // Z-index layers
-  Z_INDEX: {
-    DROPDOWN: 100,
-    TOOLTIP: 9999,
-    POPUP: 10000,
-    MODAL: 10001,
-    DRAG: 1000,
-    SIDEBAR: 50,
-    HEADER: 40,
-  },
-
-  // Pagination
-  PAGINATION_VISIBLE_PAGES: 5,
-  PAGINATION_EDGE_PAGES: 3,
-
-  // Table
-  TABLE_ROW_HEIGHT: 48,
-  TABLE_HEADER_HEIGHT: 56,
-
-  // Input
-  DEFAULT_MAXLENGTH: 1024,
-  DEFAULT_TEXTAREA_ROWS: 3,
-
-  // Menu
-  MENU_COLLAPSED_WIDTH: 76,
-  MENU_EXPANDED_WIDTH: 246,
-  MENU_ITEM_HEIGHT: 38,
-
-  // Breakpoints (pixels)
-  BREAKPOINTS: {
-    XS: 0,
-    SM: 576,
-    MD: 768,
-    LG: 992,
-    XL: 1200,
-    XXL: 1400,
-  },
-} as const;
-
-/**
- * Type for accessing UI constants values
- */
-export type UIConstants = typeof UI_CONSTANTS;

package/core/directives/autofocus/index.ts

@@ -1,9 +0,0 @@
-import { Directive, DirectiveBinding } from "vue";
-
-export const autofocus = {
-  mounted(el: HTMLElement, binding: DirectiveBinding): void {
-    if (binding.value) {
-      el.focus();
-    }
-  },
-} as Directive;

package/core/directives/index.ts

@@ -1,2 +0,0 @@
-export * from "@core/directives/autofocus";
-export * from "@core/directives/loading";

package/core/directives/loading/index.ts

@@ -1,42 +0,0 @@
-import { DirectiveBinding } from "vue";
-import "./styles.css";
-
-interface LoadingOptions {
-  size?: "small" | "medium" | "large";
-  color?: string;
-  blur?: boolean;
-  fullscreen?: boolean;
-}
-
-export const loading = (el: HTMLElement, binding: DirectiveBinding) => {
-  const zIndex = binding.arg ? parseInt(binding.arg, 10) : 9999;
-
-  const options: LoadingOptions = typeof binding.value === "object" ? binding.value : { blur: true };
-
-  if (binding.value) {
-    el.classList.add("v-loading");
-
-    if (options.size) {
-      el.setAttribute("data-loading-size", options.size);
-    }
-
-    if (options.color) {
-      el.style.setProperty("--v-loading-spinner-color", options.color);
-    }
-
-    if (options.blur === false) {
-      el.classList.add("v-loading--no-blur");
-    }
-
-    if (options.fullscreen) {
-      el.classList.add("v-loading--fullscreen");
-    }
-
-    el.style.setProperty("--v-loading-z-index", `${zIndex}`);
-  } else {
-    el.classList.remove("v-loading", "v-loading--no-blur", "v-loading--fullscreen");
-    el.removeAttribute("data-loading-size");
-    el.style.removeProperty("--v-loading-z-index");
-    el.style.removeProperty("--v-loading-spinner-color");
-  }
-};

package/core/directives/loading/styles.css

@@ -1,71 +0,0 @@
-:root {
-  --v-loading-bg-color: var(--additional-50);
-  --v-loading-bg: rgb(from var(--v-loading-bg-color) r g b / 75%);
-  --v-loading-spinner-color: var(--primary-500, #319ed4);
-  --v-loading-spinner-size-small: 20px;
-  --v-loading-spinner-size-medium: 30px;
-  --v-loading-spinner-size-large: 40px;
-}
-
-.v-loading {
-  position: relative;
-  cursor: wait;
-}
-
-.v-loading::before {
-  content: "";
-  position: absolute;
-  z-index: var(--v-loading-z-index, 9998);
-  top: 0;
-  right: 0;
-  bottom: 0;
-  left: 0;
-  background-color: var(--v-loading-bg);
-  backdrop-filter: blur(3px);
-}
-
-.v-loading--no-blur::before {
-  backdrop-filter: none;
-}
-
-.v-loading--fullscreen {
-  position: fixed;
-  inset: 0;
-}
-
-.v-loading::after {
-  content: "";
-  position: absolute;
-  z-index: calc(var(--v-loading-z-index, 9999) + 1);
-  width: var(--v-loading-spinner-size, var(--v-loading-spinner-size-medium));
-  height: var(--v-loading-spinner-size, var(--v-loading-spinner-size-medium));
-  border: 4px solid var(--v-loading-spinner-color);
-  border-right-color: transparent;
-  animation: 0.75s linear infinite v-loading;
-  border-radius: 50%;
-  top: calc(50% - var(--v-loading-spinner-size, var(--v-loading-spinner-size-medium)) / 2);
-  left: calc(50% - var(--v-loading-spinner-size, var(--v-loading-spinner-size-medium)) / 2);
-  display: inline-block;
-}
-
-/* Spinner sizes */
-.v-loading[data-loading-size="small"]::after {
-  --v-loading-spinner-size: var(--v-loading-spinner-size-small);
-  border-width: 2px;
-}
-
-.v-loading[data-loading-size="medium"]::after {
-  --v-loading-spinner-size: var(--v-loading-spinner-size-medium);
-  border-width: 3px;
-}
-
-.v-loading[data-loading-size="large"]::after {
-  --v-loading-spinner-size: var(--v-loading-spinner-size-large);
-  border-width: 4px;
-}
-
-@keyframes v-loading {
-  to {
-    transform: rotate(360deg);
-  }
-}