@salesmind-ai/design-system 0.2.1 → 0.3.0

package/dist/nav/index.d.ts

@@ -0,0 +1,279 @@
+import React__default, { HTMLAttributes, AnchorHTMLAttributes } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+export { B as Breadcrumb, a as BreadcrumbEllipsis, b as BreadcrumbEllipsisProps, c as BreadcrumbItem, d as BreadcrumbItemProps, e as BreadcrumbLink, f as BreadcrumbLinkProps, g as BreadcrumbList, h as BreadcrumbListProps, i as BreadcrumbPage, j as BreadcrumbPageProps, k as BreadcrumbProps, l as BreadcrumbSeparator, m as BreadcrumbSeparatorProps } from '../Breadcrumb-RX-B_gDV.js';
+import { m as UtmParams } from '../types-DAlgDGzw.js';
+
+interface NavbarMobileNavItemProps extends HTMLAttributes<HTMLElement> {
+    as?: React__default.ElementType;
+    active?: boolean;
+    href?: string;
+}
+/** Full-width touch-friendly nav item for the mobile menu. */
+declare const NavbarMobileNavItem: React__default.ForwardRefExoticComponent<NavbarMobileNavItemProps & React__default.RefAttributes<HTMLElement>>;
+/** Visual separator line inside the mobile menu. */
+declare function NavbarMobileSeparator({ className }: {
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace NavbarMobileSeparator {
+    var displayName: string;
+}
+/** Actions group at the bottom of the mobile menu (CTAs, auth). */
+declare const NavbarMobileActions: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+interface NavbarMegaMenuProps {
+    /** The text or element that toggles the menu */
+    trigger: React__default.ReactNode;
+    /** The content to display inside the mega menu */
+    children: React__default.ReactNode;
+    /** Optional class name */
+    className?: string;
+    /** Whether the menu is controlled */
+    isOpen?: boolean;
+    /** Change handler for controlled state */
+    onOpenChange?: (isOpen: boolean) => void;
+    /** Presentation style of the menu */
+    variant?: 'fullWidth' | 'floating';
+}
+declare const NavbarMegaMenu: React__default.ForwardRefExoticComponent<NavbarMegaMenuProps & React__default.RefAttributes<HTMLDivElement>>;
+interface NavbarMegaMenuSectionProps {
+    /** Section heading */
+    heading?: string;
+    /** Section children (NavbarMegaMenuItems) */
+    children: React__default.ReactNode;
+    /** Optional class name */
+    className?: string;
+}
+declare function NavbarMegaMenuSection({ heading, children, className }: NavbarMegaMenuSectionProps): react_jsx_runtime.JSX.Element;
+declare namespace NavbarMegaMenuSection {
+    var displayName: string;
+}
+interface NavbarMegaMenuItemProps extends React__default.AnchorHTMLAttributes<HTMLAnchorElement> {
+    /** Icon element (e.g. lucide-react icon) */
+    icon?: React__default.ReactNode;
+    /** Item label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Render as custom element (for Next.js Link) */
+    as?: React__default.ElementType;
+}
+declare const NavbarMegaMenuItem: React__default.ForwardRefExoticComponent<NavbarMegaMenuItemProps & React__default.RefAttributes<HTMLAnchorElement>>;
+
+interface NavbarV2Props extends React__default.HTMLAttributes<HTMLElement> {
+    /** Content rendered inside the mobile menu overlay when open. */
+    mobileContent?: React__default.ReactNode;
+    /** Accessible labels for mobile toggle. Override for i18n. */
+    mobileToggleLabels?: {
+        open: string;
+        close: string;
+    };
+    /** Controlled mobile menu open state. */
+    isMenuOpen?: boolean;
+    /** Callback when mobile menu open state changes. */
+    onMenuOpenChange?: (isOpen: boolean) => void;
+    /** Enable scroll-aware glass container with border. @default true */
+    scrollBorder?: boolean;
+    /** Scroll distance (px) before glass activates. @default 32 */
+    scrollThreshold?: number;
+}
+declare const NavbarV2: React__default.ForwardRefExoticComponent<NavbarV2Props & React__default.RefAttributes<HTMLElement>>;
+interface NavbarV2BrandProps extends React__default.HTMLAttributes<HTMLElement> {
+    /** Render as custom element (e.g. Next.js Link). @default 'a' */
+    as?: React__default.ElementType;
+    href?: string;
+}
+declare const NavbarV2Brand: React__default.ForwardRefExoticComponent<NavbarV2BrandProps & React__default.RefAttributes<HTMLElement>>;
+declare const NavbarV2Tabs: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+interface NavbarV2TabProps extends React__default.HTMLAttributes<HTMLElement> {
+    /** Render as custom element (e.g. Next.js Link). @default 'button' */
+    as?: React__default.ElementType;
+    /** Whether this tab is the current page. */
+    active?: boolean;
+    /** Icon element (rendered above label). */
+    icon?: React__default.ReactNode;
+    /** Tab label text (rendered below icon). */
+    label?: string;
+    href?: string;
+}
+declare const NavbarV2Tab: React__default.ForwardRefExoticComponent<NavbarV2TabProps & React__default.RefAttributes<HTMLElement>>;
+interface NavbarV2TabMenuProps {
+    /** Icon for the tab trigger (rendered above label). */
+    icon?: React__default.ReactNode;
+    /** Label for the tab trigger (rendered below icon). */
+    label: string;
+    /** Whether this tab represents the current section. */
+    active?: boolean;
+    /** Mega menu panel content. */
+    children: React__default.ReactNode;
+    /** Optional class name. */
+    className?: string;
+    /** Controlled open state. */
+    isOpen?: boolean;
+    /** Controlled open change handler. */
+    onOpenChange?: (isOpen: boolean) => void;
+}
+declare const NavbarV2TabMenu: React__default.ForwardRefExoticComponent<NavbarV2TabMenuProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const NavbarV2Actions: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+interface FooterLink {
+    label: string;
+    href: string;
+    /** Visual "NEW" indicator badge. */
+    isNew?: boolean;
+}
+interface FooterSection {
+    title: string;
+    links: FooterLink[];
+}
+interface FooterCTA {
+    /** Primary headline (e.g., "Install Your Sales Operating System.") */
+    headline: string;
+    /** Supporting subtext below the headline. */
+    subtext?: string;
+    /** Primary CTA slot (e.g., a <Button> component). */
+    primaryCta?: React__default.ReactNode;
+    /** Secondary CTA slot (e.g., a ghost <Button>). */
+    secondaryCta?: React__default.ReactNode;
+    /** Micro trust line below the CTA actions. */
+    trustLine?: string;
+}
+interface FooterTrustBadge {
+    /** Badge label (e.g., "GDPR-ready"). */
+    label: string;
+}
+interface SiteFooterProps extends HTMLAttributes<HTMLElement> {
+    /** Strategic CTA rendered at the top of the footer. */
+    cta?: FooterCTA;
+    /** Navigation sections rendered as a 5-column grid on desktop. */
+    sections?: FooterSection[];
+    /** Quick orientation line above the navigation grid. */
+    orientationLine?: React__default.ReactNode;
+    /**
+     * Custom element to render for each link (e.g., Next.js locale-aware Link).
+     * Must accept `href`, `className`, and `children` props.
+     * @default 'a'
+     */
+    linkAs?: React__default.ElementType;
+    /** Brand logo or name slot. */
+    brand?: React__default.ReactNode;
+    /** Tagline below the brand. */
+    tagline?: React__default.ReactNode;
+    /** Social icons slot. */
+    socials?: React__default.ReactNode;
+    /** Trust amplifier badges (e.g., "Built for B2B Teams", "GDPR-ready"). */
+    trustBadges?: FooterTrustBadge[];
+    /** System controls slot (language switcher, theme toggle, etc.). */
+    controls?: React__default.ReactNode;
+    /** Legal links rendered in the bottom bar. */
+    legalLinks?: FooterLink[];
+    /** Copyright text. Falls back to a default with the current year. */
+    copyright?: React__default.ReactNode;
+    /** Company registration or legal entity info line. */
+    companyInfo?: string;
+    /** Extra content rendered below the legal bar (e.g., AI summary links). */
+    bottomExtra?: React__default.ReactNode;
+    /** @deprecated Use `controls` instead. Slot rendered in the bottom bar. */
+    bottomActions?: React__default.ReactNode;
+}
+declare const SiteFooter: React__default.ForwardRefExoticComponent<SiteFooterProps & React__default.RefAttributes<HTMLElement>>;
+
+interface LocaleOption {
+    /** ISO code, e.g. 'en', 'fr', 'es'. */
+    code: string;
+    /** Full display name, e.g. 'English', 'Français'. */
+    label: string;
+    /** Emoji flag or SVG component. Optional. */
+    flag?: React__default.ReactNode;
+    /** Short display code, e.g. 'EN', 'FR'. Used in the trigger. */
+    shortLabel?: string;
+}
+interface LocaleDropdownProps {
+    /** Available locales. */
+    locales: LocaleOption[];
+    /** Currently active locale code. */
+    activeLocale: string;
+    /** Called when user selects a locale. */
+    onLocaleChange?: (code: string) => void;
+    /**
+     * Custom element for dropdown options (e.g. Next.js Link).
+     * Receives `href` from `getHref`. @default 'button'
+     */
+    optionAs?: React__default.ElementType;
+    /** Generate href for each locale option. Used with `optionAs`. */
+    getHref?: (code: string) => string;
+    /** Additional class name. */
+    className?: string;
+    /** Direction the dropdown should open. Defaults to 'down'. */
+    direction?: 'up' | 'down';
+    /** Alignment of the dropdown panel relative to the trigger. Defaults to 'right'. */
+    align?: 'left' | 'right' | 'center';
+}
+declare const LocaleDropdown: React__default.ForwardRefExoticComponent<LocaleDropdownProps & React__default.RefAttributes<HTMLDivElement>>;
+
+interface OutboundLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    href: string;
+    context: string;
+    campaignOverride?: string;
+    mediumOverride?: string;
+    preserveExistingUTM?: boolean;
+    openInNewTab?: boolean;
+    disableTracking?: boolean;
+    /**
+     * Governed UTM parameters. When provided, the link uses the UTM governance
+     * system (buildUtmUrl) instead of the legacy appendUTMs approach.
+     *
+     * Preferred for all new code. Existing usages without utmParams continue
+     * to work via the legacy path.
+     */
+    utmParams?: UtmParams;
+    children: React__default.ReactNode;
+}
+interface OutboundClickEventDetail {
+    destination_domain: string;
+    destination_url: string;
+    utm_medium_type: string;
+    page_slug: string;
+    component_location: string;
+    timestamp: string;
+    is_cross_subdomain: boolean;
+}
+declare const OutboundLink: React__default.ForwardRefExoticComponent<OutboundLinkProps & React__default.RefAttributes<HTMLAnchorElement>>;
+
+/**
+ * Check if a URL is exempt from UTM tagging.
+ * Uses both legacy patterns and governed URL classification.
+ */
+declare const isExemptUrl: (urlStr: string) => boolean;
+/**
+ * Append governed UTM parameters to a URL using `buildUtmUrl`.
+ * Preferred over the legacy `appendUTMs` function.
+ */
+declare const appendGovernedUTMs: (href: string, params: UtmParams, preserveExisting?: boolean) => string;
+/**
+ * @deprecated Prefer `appendGovernedUTMs` with governed `UtmParams`.
+ *
+ * Legacy UTM append function. Uses non-governed defaults:
+ * - utm_source = 'salesmind' (not in governed enum)
+ * - utm_medium = 'outbound_link' (snake_case, not in governed enum)
+ *
+ * Retained for backward compatibility. Consumers should migrate to
+ * the `utmParams` prop on OutboundLink.
+ */
+declare const appendUTMs: (href: string, context: string, pageSlug: string, options: {
+    mediumOverride?: string;
+    campaignOverride?: string;
+    preserveExisting?: boolean;
+}) => string;
+
+/**
+ * A wrapper specifically designed to be passed into MDX component mappings.
+ * It provides defaults suitable for markdown content.
+ *
+ * Usage:
+ * <MDXRemote components={{ a: MDXOutboundLink }} />
+ */
+declare const MDXOutboundLink: ({ href, children, ...props }: React__default.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href?: string;
+}) => react_jsx_runtime.JSX.Element;
+
+export { type FooterCTA, type FooterLink, type FooterSection, type FooterTrustBadge, LocaleDropdown, type LocaleDropdownProps, type LocaleOption, MDXOutboundLink, NavbarMegaMenu, NavbarMegaMenuItem, type NavbarMegaMenuItemProps, type NavbarMegaMenuProps, NavbarMegaMenuSection, type NavbarMegaMenuSectionProps, NavbarMobileActions, NavbarMobileNavItem, type NavbarMobileNavItemProps, NavbarMobileSeparator, NavbarV2, NavbarV2Actions, NavbarV2Brand, type NavbarV2BrandProps, type NavbarV2Props, NavbarV2Tab, NavbarV2TabMenu, type NavbarV2TabMenuProps, type NavbarV2TabProps, NavbarV2Tabs, type OutboundClickEventDetail, OutboundLink, type OutboundLinkProps, SiteFooter, type SiteFooterProps, appendGovernedUTMs, appendUTMs, isExemptUrl };