/**
 * Create a Polen URL path that respects the configured base path for UI navigation.
 *
 * **Warning:** When using this with raw `<a>` tags instead of React Router's Link component,
 * you lose the following benefits:
 * - Client-side navigation (faster, no page refresh)
 * - Browser history management and back/forward optimization
 * - Scroll position restoration
 * - Route preloading and prefetching
 * - Consistent navigation state management
 * - Better accessibility features (screen reader announcements)
 *
 * Consider using React Router's `Link` component with `to={polenUrlPath(...)}` for better UX.
 *
 * @param segments - Path segments to join (e.g., 'reference', 'Pokemon')
 * @returns Full URL path with base path (e.g., '/demos/pokemon/reference/Pokemon')
 *
 * @example
 * polenUrlPath('reference', 'Pokemon') // '/demos/pokemon/reference/Pokemon'
 * polenUrlPath('/reference/Pokemon') // '/demos/pokemon/reference/Pokemon'
 * polenUrlPath('reference/Pokemon#field') // '/demos/pokemon/reference/Pokemon#field'
 */
export declare const polenUrlPath: (...segments: string[]) => string;
//# sourceMappingURL=polen-url.d.ts.map