hitpa-common-navigation 0.1.0

package/dist/menuIconMap.d.ts

@@ -0,0 +1 @@
+export declare const menuIconNameMapping: Record<string, string>;

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+import type { CSSProperties, ReactNode } from "react";
+export interface ResourceAccessClient {
+    roles?: string[];
+}
+export type ResourceAccessMap = Record<string, ResourceAccessClient | undefined>;
+export type NavigationPathField = "menuPath" | "consintMenuPath";
+export type LocalModulePreset = "product" | "provider" | "provider_management" | "user_management" | "master_management" | "product_managment" | "dashboard_mgmt" | "messaging" | "communications" | "report_claim" | "preauth_cashlesh_management" | "reimbursement_management" | "letter_management" | "claim_config_managment" | "sla_management" | "grievance_management" | "claim_audit_recovery" | "dms" | "digitization" | "fwa_desk_audit" | "webservices" | "reopenclaim_management" | "reporting" | "none";
+export interface LocalModuleConfig {
+    sectionKey?: string;
+    menuId?: string;
+    pathPrefix?: string;
+    pathPreference?: NavigationPathField[];
+}
+export type LocalModuleInput = LocalModulePreset | LocalModuleConfig;
+export interface OrderedMenuChild {
+    kcUniqueCode: string;
+    menuName: string;
+    menuSequence?: number;
+    menuPath?: string;
+    consintMenuPath?: string;
+}
+export interface OrderedMenuNode {
+    menuId?: string;
+    kcUniqueCode: string;
+    menuName: string;
+    menuSequence?: number;
+    menuPath?: string;
+    consintMenuPath?: string;
+    children?: OrderedMenuChild[];
+}
+export interface NavigationLeaf {
+    key: string;
+    label: string;
+    path: string;
+    external?: boolean;
+    meta?: OrderedMenuChild;
+}
+export interface NavigationSection {
+    key: string;
+    label: string;
+    iconKey: string;
+    icon?: ReactNode;
+    children: NavigationLeaf[];
+    order?: number;
+    meta?: OrderedMenuNode;
+}
+export interface SequenceMenuResponse {
+    dataList?: OrderedMenuNode[] | null;
+}
+export type ResolveChildPath = (args: {
+    child: OrderedMenuChild;
+    parent: OrderedMenuNode;
+    defaultPath: string;
+}) => string | undefined;
+export interface SequenceMenuOptions {
+    clientPrefix?: string;
+    pathPreference?: NavigationPathField[];
+    sectionLabelOverrides?: Record<string, string>;
+    resolveChildPath?: ResolveChildPath;
+}
+export interface SequenceMenuBehaviorOptions {
+    externalNavigation?: "replace" | "assign" | "none";
+    navigateAllInternal?: boolean;
+    noPermissionPath?: string;
+    isItemSelected?: (item: NavigationLeaf, selectedKey?: string) => boolean;
+    onNavigate?: (item: NavigationLeaf, section: NavigationSection) => void;
+}
+export interface BuildSequenceMenuSectionsOptions extends SequenceMenuOptions {
+    resourceAccess?: ResourceAccessMap | null;
+    sequenceMenu?: SequenceMenuResponse | OrderedMenuNode[] | null;
+    localModule?: LocalModuleInput;
+}
+export interface NavigationSidebarProps {
+    sections: NavigationSection[];
+    collapsed?: boolean;
+    selectedKey?: string;
+    defaultOpenKeys?: string[];
+    width?: number;
+    collapsedWidth?: number;
+    topOffset?: number;
+    title?: ReactNode;
+    footer?: ReactNode;
+    style?: CSSProperties;
+    renderSectionIcon?: (section: NavigationSection) => ReactNode;
+    isItemSelected?: (item: NavigationLeaf, selectedKey?: string) => boolean;
+    onToggleCollapse?: () => void;
+    onNavigate?: (item: NavigationLeaf, section: NavigationSection) => void;
+}
+export type SequenceMenuSidebarUiOptions = Omit<NavigationSidebarProps, "sections" | "collapsed" | "selectedKey" | "isItemSelected" | "onToggleCollapse" | "onNavigate">;
+export interface SequenceMenuSidebarProps {
+    resourceAccess?: ResourceAccessMap | null;
+    sequenceMenu?: SequenceMenuResponse | OrderedMenuNode[] | null;
+    pathname?: string;
+    collapsed?: boolean;
+    onCollapse?: () => void;
+    navigate?: (path: string, options?: {
+        replace?: boolean;
+    }) => void;
+    localModule?: LocalModuleInput;
+    redirectOnNoPermission?: boolean;
+    onMenuClick?: (item: NavigationLeaf, section: NavigationSection) => void;
+    menuOptions?: SequenceMenuOptions;
+    behavior?: SequenceMenuBehaviorOptions;
+    ui?: SequenceMenuSidebarUiOptions;
+}
+export type SequenceMenuLoader = () => Promise<SequenceMenuResponse | OrderedMenuNode[] | null | undefined>;
+export interface HitpaSideBarProps extends Omit<SequenceMenuSidebarProps, "resourceAccess" | "sequenceMenu" | "pathname" | "navigate"> {
+    loadSequenceMenu: SequenceMenuLoader;
+    tokenStorageKey?: string;
+    defaultCollapsed?: boolean;
+    onLoadError?: (error: unknown) => void;
+}

package/dist/utils/menuBuilder.d.ts

@@ -0,0 +1,4 @@
+import type { BuildSequenceMenuSectionsOptions, LocalModuleConfig, LocalModuleInput, NavigationSection, ResourceAccessMap } from "../types";
+export declare function getLocalModuleConfig(localModule?: LocalModuleInput): LocalModuleConfig;
+export declare function getAuthorizedMenuCodes(resourceAccess?: ResourceAccessMap | null, clientPrefix?: string): Set<string>;
+export declare function buildSequenceMenuSections({ resourceAccess, sequenceMenu, clientPrefix, pathPreference, localModule, resolveChildPath }: BuildSequenceMenuSectionsOptions): NavigationSection[];

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "hitpa-common-navigation",
+  "version": "0.1.0",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.0",
+    "@mui/icons-material": "^6.4.12",
+    "@mui/material": "^6.4.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.0.0 || ^7.0.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^6.0.1",
+    "typescript": "^5.0.0",
+    "vite": "^8.0.7"
+  }
+}