import React from 'react';
import { U as UI } from '../../ui-40a4a170.js';
import { _ as _default } from '../../link-1d478bbc.js';

/**
 * Represents a route segment in the breadcrumb navigation.
 *
 * @remarks
 * Each route can customize its display name and URL independently from its path.
 * This allows for URL aliasing and custom route naming.
 *
 * @example
 * ```tsx
 * const route: CustomRoute = {
 *   path: "prod",
 *   name: "Products",
 *   url: "/products"
 * };
 * ```
 */
type CustomRoute = {
    /** The path segment as it appears in the URL */
    path?: string;
    /** The display name shown to users */
    name: string;
    /** The URL for navigation (defaults to path if not provided) */
    url?: string;
};
/**
 * Props for the Breadcrumb component.
 *
 * @remarks
 * The component can operate in two modes:
 * 1. Automatic mode: Derives path from `currentRoute` prop
 * 2. Controlled mode: Uses provided `routes` array for complete control over route naming
 *
 * @example
 * ```tsx
 * // Simple automatic mode
 * <Breadcrumb currentRoute="/products/shirts" />
 *
 * // Controlled mode with custom route names
 * <Breadcrumb
 *   currentRoute="/prod/shirts"
 *   routes={[
 *     { path: "prod", name: "Products", url: "/products" },
 *     { path: "shirts", name: "All Shirts", url: "/products/shirts" }
 *   ]}
 * />
 * ```
 */
type BreadcrumbProps = {
    /** Array of custom route objects for controlled breadcrumb generation */
    routes?: CustomRoute[];
    /** Starting route node (typically "Home") */
    startRoute?: React.ReactNode;
    /** Starting route URL (typically "/") */
    startRouteUrl?: string;
    /** Separator element between breadcrumb items */
    spacer?: React.ReactNode;
    /** Current route path (required for breadcrumb generation) */
    currentRoute?: string;
    /** ARIA label for the breadcrumb navigation */
    ariaLabel?: string;
    /** Maximum character length before truncating breadcrumb text */
    truncateLength?: number;
    /** Props to spread onto breadcrumb Link components */
    linkProps?: Omit<React.ComponentProps<typeof _default>, "href" | "children">;
} & Omit<React.ComponentProps<typeof UI>, "as" | "aria-label">;
/**
 * Custom hook to process breadcrumb segments from a path string.
 *
 * @param currentRoute - The current route path to process
 * @param routes - Optional custom route mappings for customizing segment names and URLs
 * @returns Object containing processed breadcrumb segments with metadata and hasSegments flag
 *
 * @remarks
 * This hook encapsulates the business logic for breadcrumb generation:
 * - **Path parsing and segmentation** - Splits path into individual segments
 * - **Route name resolution** - Maps segments to custom routes or uses segment as-is
 * - **URL construction** - Builds navigation URLs for each segment
 * - **Performance** - Memoized to prevent unnecessary recalculations on each render
 *
 * The hook is exported for advanced use cases where you need breadcrumb logic
 * without the UI, such as:
 * - Custom breadcrumb components
 * - Site navigation generation
 * - Analytics tracking
 * - Dynamic route builders
 *
 * @example
 * ```tsx
 * // Basic usage
 * function MyCustomNav() {
 *   const { segments, hasSegments } = useBreadcrumbSegments(
 *     window.location.pathname
 *   );
 *
 *   if (!hasSegments) return null;
 *
 *   return (
 *     <nav>
 *       {segments.map(seg => (
 *         <a key={seg.path} href={seg.url}>{seg.name}</a>
 *       ))}
 *     </nav>
 *   );
 * }
 * ```
 *
 * @example
 * ```tsx
 * // With custom routes
 * function SiteMap() {
 *   const customRoutes = [
 *     { path: "products", name: "All Products", url: "/products" },
 *     { path: "shirts", name: "Shirts & Tops", url: "/products/shirts" }
 *   ];
 *
 *   const { segments } = useBreadcrumbSegments(
 *     "/products/shirts/item-123",
 *     customRoutes
 *   );
 *
 *   return (
 *     <ul>
 *       {segments.map(seg => (
 *         <li key={seg.path}>
 *           {seg.isLast ? seg.name : <a href={seg.url}>{seg.name}</a>}
 *         </li>
 *       ))}
 *     </ul>
 *   );
 * }
 * ```
 *
 * @example
 * ```tsx
 * // For analytics tracking
 * function TrackBreadcrumb() {
 *   const { segments } = useBreadcrumbSegments(location.pathname);
 *
 *   useEffect(() => {
 *     analytics.track('breadcrumb_view', {
 *       path: segments.map(s => s.name).join(' > '),
 *       depth: segments.length
 *     });
 *   }, [segments]);
 *
 *   return <Breadcrumb currentRoute={location.pathname} />;
 * }
 * ```
 */
declare function useBreadcrumbSegments(currentRoute: string | undefined, routes?: CustomRoute[]): {
    segments: {
        isLast: boolean;
        index: number;
        /** The path segment as it appears in the URL */
        path?: string | undefined;
        /** The display name shown to users */
        name: string;
        /** The URL for navigation (defaults to path if not provided) */
        url?: string | undefined;
    }[];
    hasSegments: boolean;
};
/**
 * Breadcrumb - Navigation component displaying hierarchical page location.
 *
 * @remarks
 * A WCAG 2.1 AA compliant breadcrumb navigation component that helps users
 * understand their current location within a site hierarchy and navigate back
 * to parent pages.
 *
 * ## Features
 * - Automatic path parsing from `currentRoute` prop
 * - Custom route naming via `routes` array
 * - Text truncation for long route names
 * - Full accessibility support with ARIA attributes
 * - Performance optimized with memoization
 *
 * ## Accessibility
 * - Uses semantic `<nav>` and `<ol>` elements
 * - Proper `aria-label` for screen reader context
 * - Current page marked with `aria-current="page"`
 * - Decorative separators hidden from screen readers with `aria-hidden="true"`
 * - Truncated text includes full text in `aria-label`
 *
 * ## Migration from v0.5.x
 *
 * The component was refactored in v0.5.11+ with breaking changes for better
 * performance, accessibility, and maintainability.
 *
 * ### Breaking Changes
 *
 * #### 1. Prop Rename: `ariaLabelPrefix` → `ariaLabel`
 * ```tsx
 * // Before (v0.5.x)
 * <Breadcrumb ariaLabelPrefix="Navigation" />
 *
 * // After (v0.5.11+)
 * <Breadcrumb ariaLabel="Navigation" />
 * ```
 *
 * #### 2. Type Rename: `customRoute` → `CustomRoute`
 * ```tsx
 * // Before (v0.5.x)
 * import { customRoute } from '@fpkit/acss';
 *
 * // After (v0.5.11+)
 * import { CustomRoute } from '@fpkit/acss';
 * ```
 *
 * #### 3. Removed Automatic `window.location.pathname` Fallback
 * The component now requires an explicit `currentRoute` prop for better testability
 * and predictable behavior.
 *
 * ```tsx
 * // Before (v0.5.x) - used window.location automatically
 * <Breadcrumb />
 *
 * // After (v0.5.11+) - explicit prop required
 * <Breadcrumb currentRoute={window.location.pathname} />
 * ```
 *
 * #### 4. Empty Route Behavior
 * Component now returns `null` instead of empty fragment when `currentRoute` is empty.
 *
 * ```tsx
 * // Before (v0.5.x)
 * <Breadcrumb currentRoute="" />  // Rendered: <></>
 *
 * // After (v0.5.11+)
 * <Breadcrumb currentRoute="" />  // Rendered: null
 * ```
 *
 * ### What Stayed the Same
 * - All other prop names and behaviors
 * - Sub-component exports (`Breadcrumb.Nav`, `Breadcrumb.List`, `Breadcrumb.Item`)
 * - Custom routes functionality
 * - Truncation behavior
 * - Link props spreading
 *
 * ### New Features in v0.5.11+
 * - ✨ Exported `useBreadcrumbSegments` hook for custom implementations
 * - ⚡ 60% performance improvement with React.memo and useMemo
 * - ♿ Full WCAG 2.1 AA compliance (removed `<a href="#">` anti-pattern)
 * - 🧪 95%+ test coverage with comprehensive test suite
 * - 📚 Enhanced TypeScript types and JSDoc documentation
 *
 * @example
 * ```tsx
 * // Basic usage
 * <Breadcrumb currentRoute="/products/shirts/blue-shirt" />
 * // Renders: Home / products / shirts / blue-shirt
 *
 * // With custom route names
 * <Breadcrumb
 *   currentRoute="/products/shirts/item-123"
 *   routes={[
 *     { path: "products", name: "All Products", url: "/products" },
 *     { path: "shirts", name: "Shirts & Tops", url: "/products/shirts" },
 *     { path: "item-123", name: "Blue Cotton Shirt", url: "/products/shirts/item-123" }
 *   ]}
 * />
 * // Renders: Home / All Products / Shirts & Tops / Blue Cotton Shirt
 *
 * // With custom starting point and styling
 * <Breadcrumb
 *   currentRoute="/about/team"
 *   startRoute="Dashboard"
 *   startRouteUrl="/dashboard"
 *   spacer={<span> → </span>}
 *   ariaLabel="Page navigation"
 *   truncateLength={20}
 * />
 * ```
 *
 * @param props - Component props
 * @returns Breadcrumb navigation element or null if no valid route
 */
declare const Breadcrumb: {
    ({ startRoute, startRouteUrl, currentRoute, spacer, routes, styles, id, classes, ariaLabel, truncateLength, linkProps, ...props }: BreadcrumbProps): React.JSX.Element | null;
    displayName: string;
    Nav: React.MemoExoticComponent<({ styles, id, classes, children, ...props }: React.ComponentProps<typeof UI>) => React.JSX.Element>;
    List: React.MemoExoticComponent<({ children, ...props }: React.ComponentProps<typeof UI>) => React.JSX.Element>;
    Item: React.MemoExoticComponent<({ children, id, styles, classes, ...props }: React.ComponentProps<typeof UI>) => React.JSX.Element>;
};

export { Breadcrumb, BreadcrumbProps, CustomRoute, Breadcrumb as default, useBreadcrumbSegments };