docthub-core-components 2.65.0 → 2.66.0

package/dist/src/components/overrides/ui/footer/doct-footer.d.ts

@@ -0,0 +1,2 @@
+import { DoctFooterProps } from './types';
+export declare function DoctFooter({ brand, columns, platformPolicies, enterprisePolicies, copyrightText, className, isMobileOverride, }: Readonly<DoctFooterProps>): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/overrides/ui/footer/footer-desktop.d.ts

@@ -0,0 +1,13 @@
+import { FooterBrand, FooterColumn, FooterLink } from './types';
+/** Props for the desktop footer layout. */
+interface FooterDesktopProps {
+    readonly brand?: FooterBrand;
+    readonly columns: FooterColumn[];
+    readonly platformPolicies: FooterLink[];
+    readonly enterprisePolicies: FooterLink[];
+    readonly copyrightText: string;
+    readonly className?: string;
+}
+/** Desktop-only footer layout: brand block, nav columns, platform/enterprise policies, copyright. */
+export declare function FooterDesktop({ brand, columns, platformPolicies, enterprisePolicies, copyrightText, className, }: FooterDesktopProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/components/overrides/ui/footer/footer-mobile.d.ts

@@ -0,0 +1,13 @@
+import { FooterBrand, FooterColumn, FooterLink } from './types';
+/** Props for the mobile footer layout. */
+interface FooterMobileProps {
+    readonly brand?: FooterBrand;
+    readonly columns: FooterColumn[];
+    readonly platformPolicies: FooterLink[];
+    readonly enterprisePolicies: FooterLink[];
+    readonly copyrightText: string;
+    readonly className?: string;
+}
+export declare function FooterMobile({ brand, columns, platformPolicies, enterprisePolicies, copyrightText, className, }: FooterMobileProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+/** Mobile-only footer layout: brand block, accordion sections, platform/enterprise policies, copyright. */

package/dist/src/components/overrides/ui/footer/footer-routes.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Footer-specific URLs — environment-dependent.
+ * Shared/external URLs (social, app stores) are constant and in presets.
+ */
+export type FooterRoutes = {
+    jobs: string;
+    courses: string;
+    events: string;
+    logbook: string;
+    "resume-builder": string;
+    exhibitor: string;
+    healthcareNews: string;
+    coursePages: string;
+    jobRolePages: string;
+    recruiterSolution: string;
+    instituteSolution: string;
+    eventOrganizerSolution: string;
+    membershipManagement: string;
+    qrCheckInApp: string;
+    enterpriseSolutions: string;
+    aboutUs: string;
+    mediaReleases: string;
+    contactUs: string;
+    healthcareCareerApp: string;
+    docthubHome: string;
+    termsConditions: string;
+    privacyPolicy: string;
+    cookiesPolicy: string;
+    paymentPolicy: string;
+    disclaimerPolicy: string;
+    blogs: string;
+    jobsDropYourResume: string;
+    enterpriseLogin: string;
+    enterpriseRegister: string;
+    enterpriseTermsConditions: string;
+    enterprisePrivacyPolicy: string;
+    enterprisePaymentPolicy: string;
+    libraryPlaceholder: string;
+    contactSupportPlaceholder: string;
+    courseAfter12thPlaceholder: string;
+};
+/**
+ * Footer URLs — QA environment.
+ * Uses dochub.in and dev.dochub.in.
+ */
+export declare const FOOTER_ROUTES_QA: FooterRoutes;
+/**
+ * Footer URLs — Production environment.
+ * Uses docthub.com and www.docthub.com.
+ */
+export declare const FOOTER_ROUTES_PROD: FooterRoutes;
+/**
+ * Active footer routes — resolved by nav-env (hostname or VITE_NAV_ENV).
+ * Same resolution as navigation menu; QA/prod switch together.
+ */
+export declare const FOOTER_ROUTES: FooterRoutes;

package/dist/src/components/overrides/ui/footer/footer-shared.d.ts

@@ -0,0 +1,63 @@
+import { FooterAppLink, FooterBrand, FooterLink, FooterSectionVariant } from './types';
+/** Props for FooterNavLink. */
+interface FooterNavLinkProps {
+    readonly link: FooterLink;
+    readonly className?: string;
+}
+/**
+ * Shared nav link: renders as anchor (when href) or button (when onClick only).
+ * Used for nav columns, accordion links, and policy links.
+ */
+export declare function FooterNavLink({ link, className }: FooterNavLinkProps): import("react/jsx-runtime").JSX.Element;
+/** Props for SeeAllLinkList. */
+interface SeeAllLinkListProps {
+    readonly links: FooterLink[];
+    readonly sectionVariant?: FooterSectionVariant;
+    readonly linkClassName?: string;
+    /** Wrapper className for the link list container. */
+    readonly className?: string;
+}
+/**
+ * Renders a link list with an optional "See All / See Less" toggle.
+ *
+ * When `sectionVariant` is set and the total link count exceeds the variant's
+ * threshold (`default` → 10, `compact` → 6), only the first N links are shown
+ * and a chevron toggle reveals the remaining items.
+ * When `sectionVariant` is absent, all links are always visible.
+ */
+export declare function SeeAllLinkList({ links, sectionVariant, linkClassName, className, }: SeeAllLinkListProps): import("react/jsx-runtime").JSX.Element;
+/** Props for FooterAppButton. */
+interface FooterAppButtonProps {
+    readonly appLink: FooterAppLink;
+}
+/**
+ * App store download button: opens href in new tab or triggers onClick.
+ * Shared across mobile (row) and desktop (column) layouts.
+ */
+export declare function FooterAppButton({ appLink }: FooterAppButtonProps): import("react/jsx-runtime").JSX.Element;
+/** Layout variant for FooterBrandBlock: different spacing/sizing per viewport. */
+export type FooterBrandVariant = "mobile" | "desktop";
+/** Props for FooterBrandBlock. */
+interface FooterBrandBlockProps {
+    readonly brand?: FooterBrand;
+    /** Controls tagline width, social icon size, and app buttons layout. */
+    readonly variant: FooterBrandVariant;
+}
+/**
+ * Shared brand block: logo, tagline, social links, app download buttons.
+ * Layout differs by variant: mobile uses larger icons and row app buttons.
+ */
+export declare function FooterBrandBlock({ brand, variant }: FooterBrandBlockProps): import("react/jsx-runtime").JSX.Element | null;
+/** Props for FooterCopyright. */
+interface FooterCopyrightProps {
+    readonly text: string;
+    readonly isMobile: boolean;
+    /** Optional wrapper classes for layout-specific spacing (e.g. mt-4 pt-2 vs py-2). */
+    readonly className?: string;
+}
+/**
+ * Shared copyright block: centered text with top border.
+ * Spacing differs by layout—pass className for mobile (pt-2) or desktop (py-2).
+ */
+export declare function FooterCopyright({ text, isMobile, className }: FooterCopyrightProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/overrides/ui/footer/index.d.ts

@@ -0,0 +1,2 @@
+export { DoctFooter } from './doct-footer';
+export type { DoctFooterProps, FooterAppLink, FooterBrand, FooterColumn, FooterLink, FooterSection, FooterSocialLink, } from './types';

package/dist/src/components/overrides/ui/footer/presets.d.ts

@@ -0,0 +1,6 @@
+import { FooterBrand, FooterColumn, FooterLink } from './types';
+export declare const consumerFooterBrand: FooterBrand;
+export declare const consumerFooterColumns: FooterColumn[];
+export declare const consumerFooterPlatformPolicies: FooterLink[];
+export declare const consumerFooterEnterprisePolicies: FooterLink[];
+export declare const consumerFooterCopyrightText = "\u00A92026 Docthub. All rights reserved.";

package/dist/src/components/overrides/ui/footer/types.d.ts

@@ -0,0 +1,80 @@
+import { ReactNode } from 'react';
+export interface FooterLink {
+    id: string;
+    label: string;
+    href?: string;
+    onClick?: () => void;
+}
+/**
+ * Controls the "See All" collapse threshold for a section:
+ * - `"default"` → show first 10 links, collapse the rest
+ * - `"compact"` → show first 6 links, collapse the rest
+ *
+ * When unset, all links are always visible.
+ */
+export type FooterSectionVariant = "default" | "compact";
+export interface FooterSection {
+    id: string;
+    title: string;
+    links: FooterLink[];
+    /**
+     * When set, limits visible links and adds a "See All" toggle.
+     * Use `"compact"` for smaller sections (Enterprise Access, Additional Links).
+     */
+    sectionVariant?: FooterSectionVariant;
+}
+/**
+ * A desktop column can contain multiple sections (e.g. "Company" + "Additional Links").
+ * In the mobile layout, sections are rendered as individual accordions.
+ */
+export interface FooterColumn {
+    id: string;
+    sections: FooterSection[];
+}
+export interface FooterSocialLink {
+    id: string;
+    href: string;
+    /**
+     * Used for accessible naming (e.g. "Docthub on LinkedIn").
+     */
+    ariaLabel: string;
+    icon: ReactNode;
+}
+export interface FooterAppLink {
+    id: string;
+    label: string;
+    href?: string;
+    onClick?: () => void;
+    icon: ReactNode;
+}
+export interface FooterBrand {
+    /**
+     * Brand mark rendered at the top of the footer.
+     * Provide an image for exact brand rendering, or pass custom JSX for full control.
+     */
+    logo?: ReactNode;
+    logoSrc?: string;
+    logoAlt?: string;
+    tagline?: string;
+    socialLinks?: FooterSocialLink[];
+    appLinks?: FooterAppLink[];
+}
+export interface DoctFooterProps {
+    /**
+     * Brand area configuration (logo, tagline, social, app download CTAs).
+     */
+    brand?: FooterBrand;
+    /**
+     * Footer navigation columns.
+     */
+    columns?: FooterColumn[];
+    platformPolicies?: FooterLink[];
+    enterprisePolicies?: FooterLink[];
+    copyrightText?: string;
+    className?: string;
+    /**
+     * Optional override to force mobile or desktop layout, primarily for stories
+     * and tests. When undefined, the layout is derived from window width.
+     */
+    isMobileOverride?: boolean;
+}

package/dist/src/components/overrides/ui/navigation-menu/doct-navigation-menu.d.ts

@@ -1,2 +1,8 @@
 import { DoctNavigationMenuProps } from './types';
-export declare function DoctNavigationMenu({ groups, className, isMobileOverride, variant, }: Readonly<DoctNavigationMenuProps>): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Unified navigation entry point that delegates to variant-specific components.
+ *
+ * Consumers can also use {@link IndividualNavigationMenu} or
+ * {@link OrganizationNavigationMenu} directly for tighter control.
+ */
+export declare function DoctNavigationMenu({ groups, className, isMobileOverride, variant, }: Readonly<DoctNavigationMenuProps>): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/overrides/ui/navigation-menu/index.d.ts

@@ -1,2 +1,9 @@
 export { DoctNavigationMenu } from './doct-navigation-menu';
-export type { DoctNavigationMenuProps, DoctNavigationMenuVariant, MobileMenuCategory, NavigationMenuGroup, NavigationMenuGroupVariant, NavigationMenuItem, NavigationMenuSection, } from './types';
+export type { IndividualNavRoutes } from './individual-nav-routes';
+export { INDIVIDUAL_NAV_ROUTES, INDIVIDUAL_NAV_ROUTES_PROD, INDIVIDUAL_NAV_ROUTES_QA, } from './individual-nav-routes';
+export { IndividualNavigationMenu } from './individual-navigation-menu';
+export { isProdNav, isQaNav, resolveNavEnv } from './nav-env';
+export type { OrganizationNavRoutes } from './organization-nav-routes';
+export { ORGANIZATION_NAV_ROUTES, ORGANIZATION_NAV_ROUTES_PROD, ORGANIZATION_NAV_ROUTES_QA, } from './organization-nav-routes';
+export { OrganizationNavigationMenu } from './organization-navigation-menu';
+export type { DoctNavigationMenuProps, DoctNavigationMenuVariant, IndividualNavigationMenuProps, MobileMenuCategory, NavigationMenuGroup, NavigationMenuGroupVariant, NavigationMenuItem, NavigationMenuSection, OrganizationNavigationMenuProps, } from './types';

package/dist/src/components/overrides/ui/navigation-menu/individual-nav-routes.d.ts

@@ -0,0 +1,34 @@
+export type IndividualNavRoutes = {
+    jobs: string;
+    courses: string;
+    events: string;
+    "resume-builder": string;
+    logbook: string;
+    exhibitor: string;
+    library: string;
+    news: string;
+    "course-pages": string;
+    "job-role-pages": string;
+    "explore-courses-after-12th": string;
+    "about-us": string;
+    "media-release": string;
+    "press-kit": string;
+    policies: string;
+    "contact-us": string;
+    healthcareCareerApp: string;
+};
+/**
+ * Route URLs for Individual navigation menu — QA environment.
+ * Uses dev.dochub.in for app-specific pages.
+ */
+export declare const INDIVIDUAL_NAV_ROUTES_QA: IndividualNavRoutes;
+/**
+ * Route URLs for Individual navigation menu — Production environment.
+ * Uses docthub.com subdomains and www.docthub.com for app pages.
+ */
+export declare const INDIVIDUAL_NAV_ROUTES_PROD: IndividualNavRoutes;
+/**
+ * Active routes — resolved by nav-env (hostname or VITE_NAV_ENV).
+ * Shared with organization nav; both switch QA/prod together.
+ */
+export declare const INDIVIDUAL_NAV_ROUTES: IndividualNavRoutes;

package/dist/src/components/overrides/ui/navigation-menu/individual-navigation-menu-desktop.d.ts

@@ -0,0 +1,7 @@
+import { NavigationMenuGroup } from './types';
+interface IndividualDesktopMenuProps {
+    readonly groups: NavigationMenuGroup[];
+    readonly className?: string;
+}
+export declare function IndividualDesktopMenu({ groups, className }: IndividualDesktopMenuProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/components/overrides/ui/navigation-menu/individual-navigation-menu-mobile.d.ts

@@ -0,0 +1,8 @@
+import { MobileMenuCategory, NavigationMenuGroup } from './types';
+interface IndividualMobileMenuProps {
+    readonly categories?: MobileMenuCategory[];
+    readonly groups?: NavigationMenuGroup[];
+    readonly className?: string;
+}
+export declare function IndividualMobileMenu({ categories, groups, className }: IndividualMobileMenuProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/components/overrides/ui/navigation-menu/individual-navigation-menu.d.ts

@@ -0,0 +1,8 @@
+import { IndividualNavigationMenuProps } from './types';
+/**
+ * Navigation menu tailored for the **individual** audience.
+ *
+ * Desktop renders `individualNavigationGroups`; mobile renders the unified
+ * category accordion. When custom `groups` are supplied they take precedence.
+ */
+export declare function IndividualNavigationMenu({ groups, className, isMobileOverride, }: Readonly<IndividualNavigationMenuProps>): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/overrides/ui/navigation-menu/nav-env.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolves whether navigation links should use QA or production routes.
+ * Used by both individual and organization nav menus.
+ *
+ * Resolution order:
+ * 1. VITE_NAV_ENV — explicit override (qa | production | prod | dev)
+ * 2. window.location.hostname — localhost → QA; docthub.com → prod; dochub.in → QA
+ * 3. import.meta.env.PROD — prod build → prod, dev → QA
+ */
+export declare function resolveNavEnv(): "qa" | "production";
+/** True when nav links should point to production (docthub.com). */
+export declare function isProdNav(): boolean;
+/** True when nav links should point to QA (dochub.in). */
+export declare function isQaNav(): boolean;

package/dist/src/components/overrides/ui/navigation-menu/navigation-menu-adapter.d.ts

@@ -1,4 +1,3 @@
-import { DoctNavigationMenuVariant, MobileMenuCategory, NavigationMenuGroup } from './types';
-export declare function getDesktopGroups(variant: DoctNavigationMenuVariant): NavigationMenuGroup[];
-/** Mobile: top-level \"For Individuals\" and \"For Organizations\" — each expands to nested accordion. */
+import { MobileMenuCategory } from './types';
+/** Mobile: top-level "For Individuals" and "For Organizations" — each expands to nested accordion. */
 export declare function getMobileCategoriesFromPresets(): MobileMenuCategory[];

package/dist/src/components/overrides/ui/navigation-menu/organization-nav-routes.d.ts

@@ -0,0 +1,28 @@
+export type OrganizationNavRoutes = {
+    "recruiter-solution": string;
+    "institute-solution": string;
+    "events-organizer-solution": string;
+    "membership-management": string;
+    "qr-check-in-app": string;
+    "what-is-enterprise": string;
+    "request-demo": string;
+    "contact-sales": string;
+    "enterprise-login": string;
+    "create-enterprise-account": string;
+    "contact-support": string;
+};
+/**
+ * Route URLs for Organization navigation menu — QA environment.
+ * Uses dev.dochub.in for solution landing pages.
+ */
+export declare const ORGANIZATION_NAV_ROUTES_QA: OrganizationNavRoutes;
+/**
+ * Route URLs for Organization navigation menu — Production environment.
+ * Uses www.docthub.com for solution pages, enterprise.docthub.com for login/register.
+ */
+export declare const ORGANIZATION_NAV_ROUTES_PROD: OrganizationNavRoutes;
+/**
+ * Active routes — resolved by nav-env (hostname or VITE_NAV_ENV).
+ * Shared with individual nav; both switch QA/prod together.
+ */
+export declare const ORGANIZATION_NAV_ROUTES: OrganizationNavRoutes;

package/dist/src/components/overrides/ui/navigation-menu/organization-navigation-menu-desktop.d.ts

@@ -0,0 +1,7 @@
+import { NavigationMenuGroup } from './types';
+interface OrganizationDesktopMenuProps {
+    readonly groups: NavigationMenuGroup[];
+    readonly className?: string;
+}
+export declare function OrganizationDesktopMenu({ groups, className }: OrganizationDesktopMenuProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/components/overrides/ui/navigation-menu/organization-navigation-menu-mobile.d.ts

@@ -0,0 +1,8 @@
+import { MobileMenuCategory, NavigationMenuGroup } from './types';
+interface OrganizationMobileMenuProps {
+    readonly categories?: MobileMenuCategory[];
+    readonly groups?: NavigationMenuGroup[];
+    readonly className?: string;
+}
+export declare function OrganizationMobileMenu({ categories, groups, className, }: OrganizationMobileMenuProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/components/overrides/ui/navigation-menu/organization-navigation-menu.d.ts

@@ -0,0 +1,8 @@
+import { OrganizationNavigationMenuProps } from './types';
+/**
+ * Navigation menu tailored for the **organization** audience.
+ *
+ * Desktop renders `organizationNavigationGroups`; mobile renders the unified
+ * category accordion. When custom `groups` are supplied they take precedence.
+ */
+export declare function OrganizationNavigationMenu({ groups, className, isMobileOverride, }: Readonly<OrganizationNavigationMenuProps>): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/overrides/ui/navigation-menu/types.d.ts

@@ -9,6 +9,8 @@ export interface NavigationMenuItem {
     onClick?: () => void;
 }
 export interface NavigationMenuSection {
+    /** Inherits from parent group when omitted (e.g. "About Docthub" uses group's "highlighted"). */
+    variant?: NavigationMenuGroupVariant;
     id: string;
     title: string;
     items: NavigationMenuItem[];
@@ -17,6 +19,10 @@ export interface NavigationMenuSection {
      * Useful for splitting groups like links vs. meta pages within a section.
      */
     hasSeparatorAfterIndex?: number;
+    /**
+     * When true, omits horizontal padding from the section's title and item container.
+     */
+    noPadding?: boolean;
     /**
      * Optional footer area rendered below the section items in mobile layout.
      * Useful for cards or grouped links that conceptually belong to this section.
@@ -26,8 +32,10 @@ export interface NavigationMenuSection {
 export type NavigationMenuGroupVariant = "default" | "highlighted";
 export interface NavigationMenuGroup {
     id: string;
-    title: string;
+    title?: string;
     sections: NavigationMenuSection[];
+    noPadding?: boolean;
+    noTopBorder?: boolean;
     /**
      * When set to `"highlighted"`, the group is rendered with a subtle
      * background emphasis (used for the \"About Docthub\" column).
@@ -81,3 +89,31 @@ export interface DoctNavigationMenuProps {
      */
     isMobileOverride?: boolean;
 }
+/** Props for the individual-specific navigation menu component. */
+export interface IndividualNavigationMenuProps {
+    /**
+     * Fully custom navigation structure. When provided, this takes
+     * precedence over the individual presets.
+     */
+    groups?: NavigationMenuGroup[];
+    className?: string;
+    /**
+     * Optional override to force mobile or desktop layout, primarily for stories
+     * and tests. When undefined, the layout is derived from `useIsMobile`.
+     */
+    isMobileOverride?: boolean;
+}
+/** Props for the organization-specific navigation menu component. */
+export interface OrganizationNavigationMenuProps {
+    /**
+     * Fully custom navigation structure. When provided, this takes
+     * precedence over the organization presets.
+     */
+    groups?: NavigationMenuGroup[];
+    className?: string;
+    /**
+     * Optional override to force mobile or desktop layout, primarily for stories
+     * and tests. When undefined, the layout is derived from `useIsMobile`.
+     */
+    isMobileOverride?: boolean;
+}

package/dist/src/index.d.ts

@@ -38,5 +38,7 @@ export { Tabs as DoctTabs, Tabs as DoctCustomTabs, TabsContent as DoctTabsConten
 export { Toaster as DoctToaster, toast as doctToast, } from './components/ui/toast';
 export { Tooltip as DoctTooltip, TooltipContent as DoctTooltipContent, TooltipProvider as DoctTooltipProvider, TooltipTrigger as DoctTooltipTrigger, } from './components/ui/tooltip';
 export { useAutocompleteCheckbox } from './hooks/useAutocompleteCheckbox';
+export { DoctFooter, type DoctFooterProps, type FooterAppLink, type FooterBrand, type FooterColumn, type FooterLink, type FooterSection, type FooterSocialLink, } from './components/overrides/ui/footer';
+export { DoctNavigationMenu, type DoctNavigationMenuProps, type DoctNavigationMenuVariant, INDIVIDUAL_NAV_ROUTES, INDIVIDUAL_NAV_ROUTES_PROD, INDIVIDUAL_NAV_ROUTES_QA, IndividualNavigationMenu, type IndividualNavigationMenuProps, type IndividualNavRoutes, isProdNav, isQaNav, type MobileMenuCategory, type NavigationMenuGroup, type NavigationMenuGroupVariant, type NavigationMenuItem, type NavigationMenuSection, ORGANIZATION_NAV_ROUTES, ORGANIZATION_NAV_ROUTES_PROD, ORGANIZATION_NAV_ROUTES_QA, OrganizationNavigationMenu, type OrganizationNavigationMenuProps, type OrganizationNavRoutes, resolveNavEnv, } from './components/overrides/ui/navigation-menu';
 export { Breadcrumb as DoctBreadcrumb, BreadcrumbEllipsis as DoctBreadcrumbEllipsis, BreadcrumbItem as DoctBreadcrumbItem, BreadcrumbLink as DoctBreadcrumbLink, BreadcrumbList as DoctBreadcrumbList, BreadcrumbPage as DoctBreadcrumbPage, BreadcrumbSeparator as DoctBreadcrumbSeparator, } from './components/ui/breadcrumb';
 export { Timeline as DoctTimeline, type TimelineItem, } from './components/ui/timeline';

package/dist/src/vite-env.d.ts

@@ -1 +1,5 @@
 /// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_NAV_ENV?: "qa" | "dev" | "production" | "prod";
+}