docthub-core-components 2.60.0 → 2.62.0

package/dist/src/components/overrides/ui/auto-complete.d.ts

@@ -48,6 +48,8 @@ interface AutocompleteProps<T> {
     minSearchLength?: number;
     /** Control built-in bolding of matched query segments (default: false) */
     ntt?: boolean;
+    /** If true, clears the input text after selecting an option (default: true, for backward compatibility) */
+    clearInputOnSelect?: boolean;
 }
-export declare const DoctAutocomplete: <T extends OptionType>({ options, dataSource, value, onChange, change, onInputChange, placeholder, multiple, freeSolo, disabled, loading, size, variant, label, helperText, error, required, fullWidth, clearable, disableCloseOnSelect, filterOptions, getOptionLabel, getOptionValue, isOptionEqualToValue, renderOption, renderTags, fields, noOptionsText, emptyMessage, className, inputClassName, chipClassName, debounceMs, minSearchLength, ntt, ...props }: AutocompleteProps<T>) => import("react/jsx-runtime").JSX.Element;
+export declare const DoctAutocomplete: <T extends OptionType>({ options, dataSource, value, onChange, change, onInputChange, placeholder, multiple, freeSolo, disabled, loading, size, variant, label, helperText, error, required, fullWidth, clearable, disableCloseOnSelect, filterOptions, getOptionLabel, getOptionValue, isOptionEqualToValue, renderOption, renderTags, fields, noOptionsText, emptyMessage, className, inputClassName, chipClassName, debounceMs, minSearchLength, ntt, clearInputOnSelect, ...props }: AutocompleteProps<T>) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,2 @@
+import { DoctNavigationMenuProps } from './types';
+export declare function DoctNavigationMenu({ groups, className, isMobileOverride, variant, }: Readonly<DoctNavigationMenuProps>): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,2 @@
+export { DoctNavigationMenu } from './doct-navigation-menu';
+export type { DoctNavigationMenuProps, DoctNavigationMenuVariant, MobileMenuCategory, NavigationMenuGroup, NavigationMenuGroupVariant, NavigationMenuItem, NavigationMenuSection, } from './types';

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

@@ -0,0 +1,4 @@
+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. */
+export declare function getMobileCategoriesFromPresets(): MobileMenuCategory[];

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

@@ -0,0 +1,11 @@
+import { NavigationMenuGroup } from './types';
+interface NavigationMenuDesktopProps {
+    readonly groups: NavigationMenuGroup[];
+    readonly className?: string;
+}
+/**
+ * Desktop mega menu rendered at widths >= 1024px.
+ * Uses fixed 16px side gutters for 1024-1279px and keeps centered max width on larger screens.
+ */
+export declare function NavigationMenuDesktop({ groups, className }: NavigationMenuDesktopProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+import { NavigationMenuItem, NavigationMenuSection } from './types';
+interface NavItemRootProps {
+    readonly item: NavigationMenuItem;
+    readonly className?: string;
+    readonly children: ReactNode;
+}
+export declare function NavItemRoot({ item, className, children }: NavItemRootProps): import("react/jsx-runtime").JSX.Element;
+interface SectionItemsProps {
+    readonly section: NavigationMenuSection;
+    readonly renderItem: (item: NavigationMenuItem, index: number) => ReactNode;
+}
+export declare function SectionItems({ section, renderItem }: SectionItemsProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,14 @@
+import { MobileMenuCategory, NavigationMenuGroup } from './types';
+interface NavigationMenuMobileProps {
+    /** Nested accordion: For Individuals, For Organizations, About Docthub. */
+    readonly categories?: MobileMenuCategory[];
+    /** Flat groups (custom / legacy). */
+    readonly groups?: NavigationMenuGroup[];
+    readonly className?: string;
+}
+/**
+ * Mobile accordion menu. With categories: top-level "For Individuals", "For Organizations",
+ * "About Docthub" — each expands to show nested groups. With flat groups: legacy single-level.
+ */
+export declare function NavigationMenuMobile({ categories, groups, className }: NavigationMenuMobileProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,7 @@
+import { NavigationMenuGroup } from './types';
+export declare const individualNavigationGroups: NavigationMenuGroup[];
+/**
+ * Organization navigation presets — structure matches Figma Design System
+ * @see https://www.figma.com/design/R1AZDuYlTmwqN75mieBIMz (node 8194-3964)
+ */
+export declare const organizationNavigationGroups: NavigationMenuGroup[];

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

@@ -0,0 +1,83 @@
+import { ReactNode } from 'react';
+export interface NavigationMenuItem {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: ReactNode;
+    href?: string;
+    active?: boolean;
+    onClick?: () => void;
+}
+export interface NavigationMenuSection {
+    id: string;
+    title: string;
+    items: NavigationMenuItem[];
+    /**
+     * Zero-based index after which a visual separator should be rendered.
+     * Useful for splitting groups like links vs. meta pages within a section.
+     */
+    hasSeparatorAfterIndex?: number;
+    /**
+     * Optional footer area rendered below the section items in mobile layout.
+     * Useful for cards or grouped links that conceptually belong to this section.
+     */
+    footer?: ReactNode;
+}
+export type NavigationMenuGroupVariant = "default" | "highlighted";
+export interface NavigationMenuGroup {
+    id: string;
+    title: string;
+    sections: NavigationMenuSection[];
+    /**
+     * When set to `"highlighted"`, the group is rendered with a subtle
+     * background emphasis (used for the \"About Docthub\" column).
+     */
+    variant?: NavigationMenuGroupVariant;
+    /**
+     * Optional footer area rendered at the bottom of the group, e.g. a CTA card.
+     */
+    footer?: ReactNode;
+    /**
+     * Controls the default open state for the group in the mobile layout.
+     */
+    defaultOpen?: boolean;
+    /**
+     * In mobile layout: "vertical" = label above tagline; "horizontal" = label and tagline on one line.
+     * Used when responsive menu shows both individual + organization groups.
+     */
+    taglineLayout?: "vertical" | "horizontal";
+}
+/**
+ * Mobile category for nested accordion: "For Individuals", "For Organizations", "About Docthub".
+ * Each category expands to show its groups (Explore, Professional Tools, etc.).
+ */
+export interface MobileMenuCategory {
+    id: string;
+    title: string;
+    groups: NavigationMenuGroup[];
+}
+/**
+ * High-level menu presets that the navigation component can render.
+ * When `groups` is not provided, the `variant` determines which preset
+ * structure is used.
+ */
+export type DoctNavigationMenuVariant = "individual" | "organization";
+export interface DoctNavigationMenuProps {
+    /**
+     * Optional preset variant. When provided and `groups` is omitted,
+     * the component will render a predefined navigation structure that
+     * matches the Docthub design system for the given audience.
+     */
+    variant?: DoctNavigationMenuVariant;
+    /**
+     * Fully custom navigation structure. When provided, this takes
+     * precedence over the `variant` 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docthub-core-components",
-  "version": "2.60.0",
+  "version": "2.62.0",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",