@abpjs/theme-shared 2.9.0 → 3.0.0

package/dist/providers/route.provider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Route Provider
+ * Translated from @abp/ng.theme.shared/lib/providers/route.provider.ts v3.0.0
+ *
+ * Provides route configuration for the theme-shared module.
+ *
+ * @since 3.0.0
+ */
+import { RoutesService } from '@abpjs/core';
+/**
+ * Configures the theme shared routes.
+ * This function is called during app initialization to register
+ * the Administration route that other modules can use as a parent.
+ *
+ * @param routes - The RoutesService instance
+ * @returns A function that performs the route configuration
+ * @since 3.0.0
+ */
+export declare function configureRoutes(routes: RoutesService): () => void;
+/**
+ * Theme shared route providers for initialization.
+ * Use this in your app setup to configure theme-shared routes.
+ *
+ * In React, you typically call this during app initialization:
+ *
+ * @example
+ * ```tsx
+ * import { initializeThemeSharedRoutes } from '@abpjs/theme-shared';
+ *
+ * // In your app initialization
+ * initializeThemeSharedRoutes();
+ * ```
+ *
+ * @since 3.0.0
+ */
+export declare const THEME_SHARED_ROUTE_PROVIDERS: {
+    configureRoutes: typeof configureRoutes;
+};
+/**
+ * Initialize theme shared routes.
+ * Call this function during app initialization to register the Administration route.
+ *
+ * @since 3.0.0
+ *
+ * @example
+ * ```tsx
+ * import { initializeThemeSharedRoutes } from '@abpjs/theme-shared';
+ *
+ * // Call once during app initialization
+ * initializeThemeSharedRoutes();
+ * ```
+ */
+export declare function initializeThemeSharedRoutes(): void;

package/dist/services/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Services barrel export
+ * @since 3.0.0
+ */
+export * from './nav-items.service';

package/dist/services/nav-items.service.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Nav Items Service
+ * Translated from @abp/ng.theme.shared/lib/services/nav-items.service.ts v3.0.0
+ *
+ * Provides a service-based approach to managing navigation items,
+ * replacing the utility functions approach from v2.9.0.
+ *
+ * @since 3.0.0
+ */
+import type { NavItem } from '../models/nav-item';
+/**
+ * NavItemsService manages navigation items with reactive updates.
+ * This is a singleton service that provides methods to add, remove, and patch nav items.
+ *
+ * @since 3.0.0 - Replaces the nav-items utility functions
+ *
+ * @example
+ * ```tsx
+ * const navItemsService = NavItemsService.getInstance();
+ *
+ * // Add items
+ * navItemsService.addItems([
+ *   { id: 'profile', component: ProfileComponent, order: 1 },
+ *   { id: 'settings', component: SettingsComponent, order: 2 },
+ * ]);
+ *
+ * // Subscribe to changes
+ * const unsubscribe = navItemsService.subscribe((items) => {
+ *   console.log('Items changed:', items);
+ * });
+ *
+ * // Remove an item
+ * navItemsService.removeItem('profile');
+ *
+ * // Patch an item
+ * navItemsService.patchItem('settings', { order: 10 });
+ * ```
+ */
+export declare class NavItemsService {
+    private static _instance;
+    private _items;
+    private _listeners;
+    /**
+     * Get singleton instance
+     * @since 3.0.0
+     */
+    static getInstance(): NavItemsService;
+    /**
+     * Reset the singleton instance (useful for testing)
+     * @internal
+     */
+    static resetInstance(): void;
+    /**
+     * Get current items (sorted by order)
+     * @since 3.0.0
+     */
+    get items(): NavItem[];
+    /**
+     * Subscribe to item changes.
+     * Returns an unsubscribe function.
+     *
+     * @param listener - Callback function to receive item updates
+     * @returns Unsubscribe function
+     * @since 3.0.0
+     */
+    subscribe(listener: (items: NavItem[]) => void): () => void;
+    /**
+     * Get items as an observable-like interface.
+     * Compatible with Angular's Observable pattern.
+     *
+     * @returns Object with subscribe method
+     * @since 3.0.0
+     */
+    get items$(): {
+        subscribe: (callback: (items: NavItem[]) => void) => {
+            unsubscribe: () => void;
+        };
+    };
+    /**
+     * Add one or more items.
+     * Items are automatically sorted by order.
+     *
+     * @param items - Array of items to add
+     * @since 3.0.0
+     */
+    addItems(items: NavItem[]): void;
+    /**
+     * Remove an item by id.
+     *
+     * @param id - The id of the item to remove
+     * @since 3.0.0
+     */
+    removeItem(id: string | number): void;
+    /**
+     * Patch an existing item by id.
+     * Updates only the specified properties.
+     *
+     * @param id - The id of the item to patch
+     * @param patch - Partial item data to merge
+     * @since 3.0.0
+     */
+    patchItem(id: string | number, patch: Partial<Omit<NavItem, 'id'>>): void;
+    /**
+     * Clear all items.
+     * @since 3.0.0
+     */
+    clear(): void;
+    /**
+     * Notify all listeners of changes.
+     */
+    private notify;
+}
+/**
+ * Get the NavItemsService singleton.
+ * @since 3.0.0
+ */
+export declare function getNavItemsService(): NavItemsService;

package/dist/utils/index.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Utils barrel export
+ * @since 3.0.0 - Removed nav-items (use NavItemsService from services instead)
+ */
 export * from './styles';
-export * from './nav-items';
 export * from './validation-utils';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abpjs/theme-shared",
-  "version": "2.9.0",
+  "version": "3.0.0",
   "description": "ABP Framework Theme Shared components for React - translated from @abp/ng.theme.shared",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -27,11 +27,12 @@
     "next-themes": "^0.4.6",
     "react-hook-form": "^7.48.0",
     "react-icons": "^5.5.0",
-    "@abpjs/core": "2.9.0"
+    "@abpjs/core": "3.0.0"
   },
   "devDependencies": {
-    "@abp/ng.theme.shared": "2.9.0",
-    "@vitest/coverage-v8": "^3.2.0"
+    "@abp/ng.theme.shared": "3.0.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "vitest": "^1.6.0"
   },
   "author": "tekthar.com",
   "license": "LGPL-3.0",