@luigi-project/core-modular 0.0.3-dev.20260360050 → 0.0.3-dev.20260380047

package/package.json

@@ -18,5 +18,5 @@
     "micro-frontends",
     "microfrontends"
   ],
-  "version": "0.0.3-dev.20260360050"
+  "version": "0.0.3-dev.20260380047"
 }

package/services/navigation.service.d.ts

@@ -1,5 +1,5 @@
 import { Luigi } from '../core-api/luigi';
-import { AppSwitcher, LeftNavData, NavigationRequestParams, NavItem, Node, PathData, TabNavData, TopNavData } from '../types/navigation';
+import { AppSwitcher, LeftNavData, NavigationOptions, NavigationRequestParams, NavItem, Node, PathData, TabNavData, TopNavData } from '../types/navigation';
 import { NodeDataManagementService } from './node-data-management.service';
 import { ModalService } from './modal.service';
 export declare class NavigationService {
@@ -87,7 +87,7 @@ export declare class NavigationService {
      * @param nodesInPath - An array of nodes representing the path in the virtual tree.
      * @param pathParams - An object containing path parameters for the virtual tree.
      */
-    buildVirtualTree(node: Node, nodesInPath: any, pathParams: Record<string, any>): void;
+    buildVirtualTree(node: Node, segment: any, pathParams: Record<string, any>): Node[] | undefined;
     /**
      * Requires str to include :virtualPath
      * and pathParams consist of :virtualSegment_N
@@ -106,5 +106,5 @@ export declare class NavigationService {
      * @param fromVirtualTreeRoot - A boolean indicating whether to build the path from the virtual tree root.
      * @returns The constructed path string.
      */
-    buildPath(incomingPath: string, fromVirtualTreeRoot?: boolean): Promise<string>;
+    buildPath(incomingPath: string, options: NavigationOptions): Promise<string>;
 }

package/types/navigation.d.ts

@@ -97,6 +97,7 @@ export interface Node {
     isRootNode?: boolean;
     keepSelectedForChildren?: boolean;
     label?: string;
+    navigationContext?: string;
     onNodeActivation?: (node: Node) => boolean | void;
     openNodeInModal?: boolean;
     pageErrorHandler?: PageErrorHandler;

package/utilities/helpers/generic-helpers.d.ts

@@ -107,4 +107,16 @@ export declare const GenericHelpers: {
      * @returns
      */
     escapeRegExp(string: string): string;
+    /**
+     * Checks if a given input string begins with a hash or a slash
+     * @param {string} path
+     * @returns {boolean}
+     */
+    hasHashOrSlash: (path: string) => boolean;
+    /**
+     * Removes leading hash or slash of a string
+     * @param {string} path
+     * @returns {string}
+     */
+    getPathWithoutHashOrSlash: (path: string) => string;
 };

package/utilities/helpers/routing-helpers.d.ts

@@ -262,6 +262,14 @@ export declare const RoutingHelpers: {
      * @param {*} pathParams
      */
     getDynamicNodeValue(node: Node, pathParams: Record<string, string>): string | undefined;
+    /**
+     *  Recursively constructs the full path for a given node by concatenating its path segment with those of its ancestors.
+     *  If `params` are provided, they are appended as query parameters to the final path.
+     * @param node - The node for which to construct the path. It is expected to have a `pathSegment` property and optionally a `parent` property pointing to its parent node.
+     * @param params - Optional query parameters to append to the path. If provided, it should be a string in the format of URL query parameters (e.g., "key=value&anotherKey=anotherValue").
+     * @returns The constructed path as a string, including any query parameters if provided.
+     */
+    getNodePath(node: Node, params?: string): string;
     /**
      * Builds a route string by recursively traversing up the node hierarchy and concatenating path segments.
      * @param node - The current node from which to start building the route.
@@ -269,6 +277,25 @@ export declare const RoutingHelpers: {
      * @param params - Optional query parameters to append to the final route.
      * @returns a string representing the full route from the root to the given node, including query parameters if provided.
      */
-    buildRoute(node: Node, path?: string, params?: string): string;
-    substituteViewUrl(viewUrl: string, pathData: PathData, luigi: Luigi): string;
+    buildRoute(node: Node, path: string, params?: string): string;
+    substituteViewUrl(viewUrl: string, pathParams: Record<string, string>, luigi: Luigi): string;
+    /**
+     *  Generates a sub-path for a given node by replacing dynamic parameters in the node's path with actual values from pathParams.
+     * @param node - The node for which to generate the sub-path. It is expected to have a `pathSegment` property and optionally a `parent` property pointing to its parent node.
+     * @param nodePathParams - An object containing the values for dynamic parameters in the node's path. The keys should match the parameter names in the path segments.
+     * @returns A string representing the sub-path with dynamic parameters replaced by their corresponding values from pathParams.
+     */
+    getSubPath(node: any, nodePathParams: any): string;
+    /**
+     * Concatenates a base path and a relative path
+     *
+     * The function performs the following steps:
+     * 1. Removes any trailing '/' from the base path.
+     * 2. If the relative path does not start with '/', it adds a '/' between the base and relative paths.
+     * 3. Concatenates the base path and the relative path.
+     * @param basePath The base path to which the relative path will be appended. It may or may not end with a '/' character.
+     * @param relativePath The relative path to append to the base path. It may or may not start with a '/' character.
+     * @returns A string representing the concatenated path, with exactly one '/' character between the base and relative paths.
+     */
+    concatenatePath(basePath: any, relativePath?: any): string;
 };