@donotdev/ui 0.0.6 → 0.0.8

package/dist/internal/devtools/components/DesignTab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DesignTab.d.ts","sourceRoot":"","sources":["../../../../src/internal/devtools/components/DesignTab.tsx"],"names":[],"mappings":"AA8CA,eAAO,MAAM,SAAS,+CAsuBrB,CAAC"}
+{"version":3,"file":"DesignTab.d.ts","sourceRoot":"","sources":["../../../../src/internal/devtools/components/DesignTab.tsx"],"names":[],"mappings":"AA+CA,eAAO,MAAM,SAAS,+CA2yBrB,CAAC"}

package/dist/internal/devtools/components/DesignTab.js

@@ -175,6 +175,9 @@ export const DesignTab = () => {
             '--input',
             '--ring',
             '--radius',
+            '--font-sans',
+            '--font-mono',
+            '--font-family',
         ];
         relevantVars.forEach((varName) => {
             const value = style.getPropertyValue(varName).trim();
@@ -194,6 +197,7 @@ export const DesignTab = () => {
     const analyzeTypography = () => {
         const elements = document.querySelectorAll('*');
         const fontSizeMap = new Map();
+        const fontFamilyMap = new Map();
         let analyzedCount = 0;
         elements.forEach((el) => {
             if (isOverlayElement(el))
@@ -216,12 +220,23 @@ export const DesignTab = () => {
             const fontSize = style.fontSize;
             const fontSizeRounded = parseFloat(fontSize).toFixed(2) + 'px';
             fontSizeMap.set(fontSizeRounded, (fontSizeMap.get(fontSizeRounded) || 0) + 1);
+            const fontFamily = style.fontFamily
+                ?.split(',')[0]
+                ?.trim()
+                ?.replace(/['"]/g, '');
+            if (fontFamily) {
+                fontFamilyMap.set(fontFamily, (fontFamilyMap.get(fontFamily) || 0) + 1);
+            }
         });
         const fontSizes = Array.from(fontSizeMap.entries())
             .map(([size, count]) => ({ size, count }))
             .sort((a, b) => b.count - a.count);
+        const fontFamilies = Array.from(fontFamilyMap.entries())
+            .map(([family, count]) => ({ family, count }))
+            .sort((a, b) => b.count - a.count);
         return {
             fontSizes,
+            fontFamilies,
             totalElements: analyzedCount,
         };
     };
@@ -376,7 +391,14 @@ export const DesignTab = () => {
                                                         flexShrink: 0,
                                                     } }), _jsxs(Text, { className: "dndev-text-xs dndev-font-mono", style: { flex: 1 }, children: [c.percentage.toFixed(1), "%"] }), _jsx(Badge, { variant: BADGE_VARIANT.SECONDARY, children: c.category })] }, i))) })),
                                 },
-                            ] }))] }) })), typography && (_jsxs(Card, { content: _jsxs(Stack, { direction: "row", align: "center", justify: "between", className: "dndev-w-full", children: [_jsx("span", { children: "Font Sizes" }), _jsxs(Badge, { variant: BADGE_VARIANT.SECONDARY, children: [typography.totalElements, " elements"] })] }), children: [_jsxs(Stack, { direction: "row", align: "center", justify: "between", children: [_jsxs(Label, { className: "dndev-text-sm dndev-font-semibold", children: [typography.fontSizes.length, " sizes"] }), (highlightedSize || Object.keys(fontSizeColors).length > 0) && (_jsx(Button, { variant: BUTTON_VARIANT.GHOST, onClick: clearHighlights, style: { padding: '0 var(--gap-xs)', height: 'auto' }, children: _jsx(Text, { className: "dndev-text-xs", children: "Clear All" }) }))] }), _jsx(Stack, { gap: "tight", className: "dndev-mt-xs", children: typography.fontSizes.map((f, i) => {
+                            ] }))] }) })), typography && typography.fontFamilies.length > 0 && (_jsx(Card, { content: _jsxs(Stack, { direction: "row", align: "center", justify: "between", className: "dndev-w-full", children: [_jsx("span", { children: "Font Families" }), _jsxs(Badge, { variant: BADGE_VARIANT.SECONDARY, children: [typography.fontFamilies.length, " families"] })] }), children: _jsx(Stack, { gap: "tight", className: "dndev-mt-xs", children: typography.fontFamilies.map((f, i) => (_jsxs(Stack, { direction: "row", justify: "between", align: "center", gap: "tight", style: {
+                            padding: 'var(--gap-sm)',
+                            borderRadius: 'var(--radius-sm)',
+                        }, children: [_jsx(Text, { className: "dndev-font-mono dndev-text-xs", style: { flex: 1 }, children: f.family }), _jsxs(Text, { className: "dndev-text-xs", style: {
+                                    opacity: 0.6,
+                                    minWidth: '2rem',
+                                    textAlign: 'end',
+                                }, children: [f.count, "\u00D7"] })] }, i))) }) })), typography && (_jsxs(Card, { content: _jsxs(Stack, { direction: "row", align: "center", justify: "between", className: "dndev-w-full", children: [_jsx("span", { children: "Font Sizes" }), _jsxs(Badge, { variant: BADGE_VARIANT.SECONDARY, children: [typography.totalElements, " elements"] })] }), children: [_jsxs(Stack, { direction: "row", align: "center", justify: "between", children: [_jsxs(Label, { className: "dndev-text-sm dndev-font-semibold", children: [typography.fontSizes.length, " sizes"] }), (highlightedSize || Object.keys(fontSizeColors).length > 0) && (_jsx(Button, { variant: BUTTON_VARIANT.GHOST, onClick: clearHighlights, style: { padding: '0 var(--gap-sm)', height: 'auto' }, children: _jsx(Text, { className: "dndev-text-xs", children: "Clear All" }) }))] }), _jsx(Stack, { gap: "tight", className: "dndev-mt-xs", children: typography.fontSizes.map((f, i) => {
                             const isOrphan = f.count < 5;
                             const isHighlighted = highlightedSize === f.size;
                             const currentColor = fontSizeColors[f.size] || '';
@@ -400,7 +422,7 @@ export const DesignTab = () => {
                                 console.log(`Found ${found.length} elements with ${f.size}`);
                             };
                             return (_jsxs(Stack, { direction: "row", justify: "between", align: "center", gap: "tight", style: {
-                                    padding: 'var(--gap-xs)',
+                                    padding: 'var(--gap-sm)',
                                     borderRadius: 'var(--radius-sm)',
                                     backgroundColor: isHighlighted
                                         ? 'var(--primary)'
@@ -412,7 +434,7 @@ export const DesignTab = () => {
                                             e.stopPropagation();
                                             findOrphanElements();
                                         }, style: {
-                                            padding: '0 var(--gap-xs)',
+                                            padding: '0 var(--gap-sm)',
                                             height: '1.5rem',
                                             minWidth: '2rem',
                                         }, title: `Find ${f.size} elements in console`, children: _jsx(Text, { className: "dndev-text-xs", children: "\uD83D\uDD0D" }) })) : (_jsx("input", { type: "color", value: currentColor || '#000000', onChange: (e) => applyFontSizeColor(f.size, e.target.value), onClick: (e) => e.stopPropagation(), style: {

package/dist/internal/layout/components/PerformanceHints.d.ts

@@ -0,0 +1,64 @@
+import type { ComponentType } from 'react';
+interface FontPreload {
+    /** Path to font file (e.g., '/fonts/Inter-latin.woff2') */
+    href: string;
+    /** Font MIME type @default 'font/woff2' */
+    type?: string;
+    /** Cross-origin setting @default 'anonymous' */
+    crossOrigin?: 'anonymous' | 'use-credentials';
+}
+interface PerformanceHintsProps {
+    /**
+     * Additional origins to preconnect to
+     * These are merged with defaults
+     */
+    preconnects?: string[];
+    /**
+     * Additional origins to dns-prefetch
+     * These are merged with defaults
+     */
+    dnsPrefetch?: string[];
+    /**
+     * Fonts to preload for faster LCP
+     * Pass string[] for simple paths, or FontPreload[] for full control
+     * @default ['/fonts/Inter-latin.woff2']
+     */
+    fontPreloads?: (string | FontPreload)[];
+    /**
+     * Disable default preconnects (use only custom ones)
+     * @default false
+     */
+    disableDefaults?: boolean;
+    /**
+     * Disable default font preloads
+     * @default false
+     */
+    disableFontPreloads?: boolean;
+}
+/**
+ * PerformanceHints component
+ *
+ * Adds preconnect, dns-prefetch, and font preload hints to improve page load.
+ * Automatically includes common third-party origins and critical fonts.
+ *
+ * @example
+ * ```tsx
+ * // Use defaults (preloads Inter-latin.woff2)
+ * <PerformanceHints />
+ *
+ * // Custom font preloads
+ * <PerformanceHints fontPreloads={['/fonts/Roboto-400-latin.woff2']} />
+ *
+ * // Full control over font preload
+ * <PerformanceHints
+ *   fontPreloads={[{ href: '/fonts/Custom.woff2', type: 'font/woff2' }]}
+ * />
+ *
+ * // Disable font preloads (e.g., when using next/font)
+ * <PerformanceHints disableFontPreloads />
+ * ```
+ */
+declare const PerformanceHints: ComponentType<PerformanceHintsProps>;
+export default PerformanceHints;
+export type { FontPreload, PerformanceHintsProps };
+//# sourceMappingURL=PerformanceHints.d.ts.map

package/dist/internal/layout/components/PerformanceHints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceHints.d.ts","sourceRoot":"","sources":["../../../../src/internal/layout/components/PerformanceHints.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAmC3C,UAAU,WAAW;IACnB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAAC;CAC/C;AAED,UAAU,qBAAqB;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,QAAA,MAAM,gBAAgB,EAAE,aAAa,CAAC,qBAAqB,CA6D1D,CAAC;AAEF,eAAe,gBAAgB,CAAC;AAChC,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/internal/layout/components/PerformanceHints.js

@@ -0,0 +1,88 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// packages/ui/src/internal/layout/components/PerformanceHints.tsx
+/**
+ * @fileoverview Performance hints for faster page loads
+ * @description Adds preconnect, dns-prefetch, and font preload hints
+ *
+ * - Preconnect establishes early connections (DNS + TCP + TLS) to origins
+ *   the page will need, saving 100-300ms per origin on slow networks.
+ * - Font preload initiates font downloads early, reducing LCP by ~500-1000ms
+ *
+ * @version 0.0.2
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { Helmet } from 'react-helmet-async';
+/**
+ * Common third-party origins that benefit from preconnect
+ * Only includes origins that are commonly used and safe to preconnect
+ */
+const DEFAULT_PRECONNECTS = [
+    // YouTube embeds - thumbnails and iframe
+    'https://img.youtube.com',
+    'https://www.youtube.com',
+    // Google Fonts (if used)
+    'https://fonts.googleapis.com',
+    'https://fonts.gstatic.com',
+    // Google APIs (Firebase, Analytics, etc.)
+    'https://www.googleapis.com',
+    // Stripe (if used)
+    'https://js.stripe.com',
+];
+/**
+ * Origins to dns-prefetch only (less aggressive than preconnect)
+ * Use for origins that might be needed but aren't certain
+ */
+const DEFAULT_DNS_PREFETCH = [
+    'https://www.google-analytics.com',
+    'https://www.googletagmanager.com',
+];
+/**
+ * Default critical fonts to preload
+ * Empty by default - apps should specify their own fonts based on their font-display strategy
+ * Note: Don't preload fonts with font-display: optional (they're meant to be non-blocking)
+ */
+const DEFAULT_FONT_PRELOADS = [];
+/**
+ * PerformanceHints component
+ *
+ * Adds preconnect, dns-prefetch, and font preload hints to improve page load.
+ * Automatically includes common third-party origins and critical fonts.
+ *
+ * @example
+ * ```tsx
+ * // Use defaults (preloads Inter-latin.woff2)
+ * <PerformanceHints />
+ *
+ * // Custom font preloads
+ * <PerformanceHints fontPreloads={['/fonts/Roboto-400-latin.woff2']} />
+ *
+ * // Full control over font preload
+ * <PerformanceHints
+ *   fontPreloads={[{ href: '/fonts/Custom.woff2', type: 'font/woff2' }]}
+ * />
+ *
+ * // Disable font preloads (e.g., when using next/font)
+ * <PerformanceHints disableFontPreloads />
+ * ```
+ */
+const PerformanceHints = ({ preconnects = [], dnsPrefetch = [], fontPreloads = [], disableDefaults = false, disableFontPreloads = false, }) => {
+    // Merge defaults with custom origins
+    const allPreconnects = disableDefaults
+        ? preconnects
+        : [...new Set([...DEFAULT_PRECONNECTS, ...preconnects])];
+    const allDnsPrefetch = disableDefaults
+        ? dnsPrefetch
+        : [...new Set([...DEFAULT_DNS_PREFETCH, ...dnsPrefetch])];
+    // Normalize font preloads to FontPreload objects
+    const normalizeFontPreload = (font) => typeof font === 'string' ? { href: font } : font;
+    const customFontPaths = fontPreloads.map((f) => typeof f === 'string' ? f : f.href);
+    const allFontPreloads = disableFontPreloads
+        ? []
+        : fontPreloads.length > 0
+            ? fontPreloads.map(normalizeFontPreload)
+            : DEFAULT_FONT_PRELOADS.filter((f) => !customFontPaths.includes(f)).map(normalizeFontPreload);
+    return (_jsxs(Helmet, { children: [allFontPreloads.map((font) => (_jsx("link", { rel: "preload", as: "font", href: font.href, type: font.type || 'font/woff2', crossOrigin: font.crossOrigin || 'anonymous' }, `font-${font.href}`))), allPreconnects.map((origin) => (_jsx("link", { rel: "preconnect", href: origin, crossOrigin: "anonymous" }, `preconnect-${origin}`))), allDnsPrefetch.map((origin) => (_jsx("link", { rel: "dns-prefetch", href: origin }, `dns-${origin}`)))] }));
+};
+export default PerformanceHints;

package/dist/internal/layout/components/footer/FooterBranding.js

@@ -20,7 +20,7 @@ import { useAppConfig } from '@donotdev/core';
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-export const FooterBranding = ({ className, size = 'xs', }) => {
+export const FooterBranding = ({ className, size = 'sm', }) => {
     const appUrl = useAppConfig('url');
     const isFrameworkSite = appUrl === 'https://donotdev.com';
     const sizeStyles = {

package/dist/internal/layout/config/presets/admin.d.ts

@@ -12,8 +12,8 @@ import type { PresetConfig } from '@donotdev/core';
  * Admin preset - admin panel layout
  *
  * Zones:
- * - Header: Logo + title (left), actions (right)
- * - Sidebar: Navigation menu, user profile at bottom
+ * - Header: Logo + title (left), GoTo + Auth + Language + Theme (right)
+ * - Sidebar: Navigation menu only (no bottom controls - they're in header)
  * - Footer: Automatic footer (copyright + legal links + DoNotDev branding)
  *
  * Mobile behavior:

package/dist/internal/layout/config/presets/admin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../../../src/internal/layout/config/presets/admin.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,EAAE,YAczB,CAAC"}
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../../../src/internal/layout/config/presets/admin.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,EAAE,YAkBzB,CAAC"}

package/dist/internal/layout/config/presets/admin.js

@@ -3,8 +3,8 @@
  * Admin preset - admin panel layout
  *
  * Zones:
- * - Header: Logo + title (left), actions (right)
- * - Sidebar: Navigation menu, user profile at bottom
+ * - Header: Logo + title (left), GoTo + Auth + Language + Theme (right)
+ * - Sidebar: Navigation menu only (no bottom controls - they're in header)
  * - Footer: Automatic footer (copyright + legal links + DoNotDev branding)
  *
  * Mobile behavior:
@@ -13,8 +13,12 @@
  */
 export const adminPreset = {
     name: 'admin',
-    // header omitted → uses DEFAULT_SLOTS.header
-    // sidebar omitted → uses DEFAULT_SLOTS.sidebar
+    // header omitted → uses DEFAULT_SLOTS.header (GoTo + Auth + Language + Theme)
+    sidebar: {
+        // content omitted → uses DEFAULT_SLOTS.sidebar.content (NavigationMenu)
+        // bottom explicitly empty - Auth/Language/Theme are in header, no duplication
+        bottom: () => null,
+    },
     footer: {},
     mobile: {
         mergedBar: {

package/dist/providers/NextJsAppProviders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NextJsAppProviders.d.ts","sourceRoot":"","sources":["../../src/providers/NextJsAppProviders.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAiDxD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,2CAyChE"}
+{"version":3,"file":"NextJsAppProviders.d.ts","sourceRoot":"","sources":["../../src/providers/NextJsAppProviders.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAuDxD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,2CAiDhE"}

package/dist/providers/NextJsAppProviders.js

@@ -15,6 +15,7 @@ import { QueryProviders, AppConfigProvider } from '@donotdev/core';
 import { useConsent } from '@donotdev/core';
 import { NextJsStoresInitializer } from '../internal/initializers/NextJsStoresInitializer';
 import FaviconHead from '../internal/layout/components/FaviconHead';
+import PerformanceHints from '../internal/layout/components/PerformanceHints';
 // import NextJsAutoMetaTags from '../internal/layout/components/NextJsAutoMetaTags'; // Deprecated - metadata now server-side
 import { DnDevLayout } from '../internal/layout/DnDevLayout';
 import { SentryInitializer } from '../internal/providers/SentryInitializer';
@@ -27,6 +28,9 @@ const PWAUpdateNotification = lazy(() => import('../internal/layout/components/P
 const LicenseWatermark = lazy(() => import('../components/license/LicenseWatermark').then((m) => ({
     default: m.LicenseWatermark,
 })));
+const RedirectOverlay = lazy(() => import('../components/common/RedirectOverlay').then((m) => ({
+    default: m.RedirectOverlay,
+})));
 /**
  * ConsentBanner - Lazy loaded consent component
  * Only shows if user hasn't consented yet
@@ -45,5 +49,5 @@ function ConsentBanner() {
 }
 export function NextJsAppProviders(props) {
     const { config = {}, layout, children, serverCookies, customStores } = props;
-    return (_jsxs(AppConfigProvider, { config: config, platform: "nextjs", children: [_jsx(SentryInitializer, {}), _jsx(HelmetProvider, { children: _jsxs(NextJsStoresInitializer, { serverCookies: serverCookies, customStores: customStores, children: [_jsx(FaviconHead, {}), _jsx(QueryProviders, { children: _jsxs(UIProviders, { children: [_jsx(DnDevLayout, { layout: layout, children: children }), _jsx(ConsentBanner, {}), _jsx(Suspense, { fallback: null, children: _jsx(PWAUpdateNotification, {}) }), _jsx(Suspense, { fallback: null, children: _jsx(LicenseWatermark, {}) })] }) })] }) })] }));
+    return (_jsxs(AppConfigProvider, { config: config, platform: "nextjs", children: [_jsx(SentryInitializer, {}), _jsx(HelmetProvider, { children: _jsxs(NextJsStoresInitializer, { serverCookies: serverCookies, customStores: customStores, children: [_jsx(FaviconHead, {}), _jsx(PerformanceHints, {}), _jsx(QueryProviders, { children: _jsxs(UIProviders, { children: [_jsx(DnDevLayout, { layout: layout, children: children }), _jsx(ConsentBanner, {}), _jsx(Suspense, { fallback: null, children: _jsx(PWAUpdateNotification, {}) }), _jsx(Suspense, { fallback: null, children: _jsx(LicenseWatermark, {}) }), _jsx(Suspense, { fallback: null, children: _jsx(RedirectOverlay, {}) })] }) })] }) })] }));
 }

package/dist/providers/ViteAppProviders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViteAppProviders.d.ts","sourceRoot":"","sources":["../../src/providers/ViteAppProviders.tsx"],"names":[],"mappings":"AAcA,OAAO,aAAa,CAAC;AACrB,OAAO,gBAAgB,CAAC;AACxB,OAAO,sBAAsB,CAAC;AAC9B,OAAO,gBAAgB,CAAC;AACxB,OAAO,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAsBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,2CA+BxD"}
+{"version":3,"file":"ViteAppProviders.d.ts","sourceRoot":"","sources":["../../src/providers/ViteAppProviders.tsx"],"names":[],"mappings":"AAcA,OAAO,aAAa,CAAC;AACrB,OAAO,gBAAgB,CAAC;AACxB,OAAO,sBAAsB,CAAC;AAC9B,OAAO,gBAAgB,CAAC;AACxB,OAAO,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA2BxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,2CAkCxD"}

package/dist/providers/ViteAppProviders.js

@@ -30,6 +30,9 @@ const HelmetProvider = lazy(() => import('react-helmet-async').then((m) => ({ de
 const FaviconHead = lazy(() => import('../internal/layout/components/FaviconHead').then((m) => ({
     default: m.default,
 })));
+const PerformanceHints = lazy(() => import('../internal/layout/components/PerformanceHints').then((m) => ({
+    default: m.default,
+})));
 /**
  * ViteAppProviders - Vite platform-specific app providers
  *
@@ -77,5 +80,5 @@ export function ViteAppProviders(props) {
         routeGroups,
         layout,
     });
-    return (_jsxs(AppConfigProvider, { config: config, platform: "vite", children: [_jsx(SentryInitializer, {}), _jsx(ViteStoresInitializer, { customStores: customStores, children: _jsx(Suspense, { fallback: null, children: _jsxs(HelmetProvider, { children: [_jsx(FaviconHead, {}), _jsx(NavigationProvider, { router: router })] }) }) })] }));
+    return (_jsxs(AppConfigProvider, { config: config, platform: "vite", children: [_jsx(SentryInitializer, {}), _jsx(ViteStoresInitializer, { customStores: customStores, children: _jsx(Suspense, { fallback: null, children: _jsxs(HelmetProvider, { children: [_jsx(FaviconHead, {}), _jsx(PerformanceHints, {}), _jsx(NavigationProvider, { router: router })] }) }) })] }));
 }

package/dist/routing/hooks/hooks.next.d.ts

@@ -10,6 +10,7 @@
 export { useNavigate, useBack, useRefresh, usePrefetch, } from './useNavigate.next';
 export { useLocation } from './useLocation.next';
 export { useParams } from './useParams.next';
+export { useRouteParam } from './useRouteParam.next';
 export { useSearchParams } from './useSearchParams.next';
 export { useMatch } from './useMatch.next';
 export { useQueryParams } from './useQueryParams.next';

package/dist/routing/hooks/hooks.next.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.next.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/hooks.next.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"hooks.next.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/hooks.next.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/routing/hooks/hooks.next.js

@@ -1 +1 @@
-"use client";import{useCallback as f}from"react";import{useRouter as h}from"next/navigation";import{isClient as x,useOverlayStore as S}from"@donotdev/core";function d(){let e=h(),t=S(r=>r.closeAll);return f((r,i)=>{if(r==="back")return t(),e.back();if(t(),i?.preserveScroll&&x()){let o=window.scrollY;i?.replace?e.replace(r):e.push(r),requestAnimationFrame(()=>{window.scrollTo({top:o,behavior:"auto"})});return}return i?.replace?e.replace(r):e.push(r)},[e,t])}function y(){let e=h();return f(()=>e.back(),[e])}function k(){let e=h();return f(()=>e.refresh(),[e])}function T(){let e=h();return f(t=>e.prefetch(t),[e])}import{usePathname as v,useSearchParams as b}from"next/navigation";function l(){let e=v(),t=b(),r=t.toString()?`?${t.toString()}`:"";return{pathname:e||"/",search:r,hash:"",state:null}}import{useParams as w}from"next/navigation";function C(){return w()}import{useSearchParams as I}from"next/navigation";function g(){return I()}import{usePathname as N}from"next/navigation";function G(e){let t=N(),r=e.replace(/:[^/]+/g,"([^/]+)").replace(/\*/g,".*"),i=new RegExp(`^${r}$`),o=t.match(i);if(!o)return null;let s=e.match(/:[^/]+/g)?.map(a=>a.slice(1))||[],n={};return s.forEach((a,c)=>{n[a]=o[c+1]||""}),{params:n,pathname:t,pattern:e}}import{useCallback as R}from"react";function $(){let e=g(),t=d(),r=l(),i=R((n,a)=>{let c=new URLSearchParams(e.toString());c.set(n,a);let m=c.toString(),P=`${r.pathname||"/"}${m?`?${m}`:""}`;t(P)},[e,t,r.pathname]),o=R(n=>{let a=new URLSearchParams(e.toString());a.delete(n);let c=a.toString(),u=`${r.pathname||"/"}${c?`?${c}`:""}`;t(u)},[e,t,r.pathname]),s=R(()=>{let n=r.pathname||"/";t(n)},[t,r.pathname]);return{query:e,setQuery:i,removeQuery:o,clearQueries:s}}import{useMemo as L}from"react";import{isClient as E,FEATURE_STATUS as Q}from"@donotdev/core";import{useAuthConfig as F}from"@donotdev/core";import{DEGRADED_AUTH_API as K}from"@donotdev/core";import*as O from"@donotdev/auth";var A=O?.useAuth;function U(e){return K[e]}function p(e){return A?A(e):U(e)}function M(e={}){let{auth:t,redirectTo:r,condition:i}=e;if(!E())return{shouldRedirect:!1,redirectTo:null,isChecking:!1};let o=l(),s=F(),n=p("user"),a=p("can"),c=p("status");return L(()=>{if(c===Q.INITIALIZING)return{shouldRedirect:!1,redirectTo:null,isChecking:!0};if(i){let u=i(n,c);return{shouldRedirect:u,redirectTo:u&&r||null,isChecking:!1}}if(t!==!1&&t!==void 0){if(!a)return{shouldRedirect:!1,redirectTo:null,isChecking:!1};if(!a.navigate(t)){let u=null;return typeof t=="object"&&t.required&&!n?o.search.includes("code=")||o.search.includes("state=")||o.search.includes("error=")?u=`${s.authRoute}${o.search}`:u=s.authRoute:typeof t=="object"&&t.role?u=s.roleRoute:typeof t=="object"&&t.tier?u=s.tierRoute:u=s.roleRoute,{shouldRedirect:!0,redirectTo:r||u,isChecking:!1}}}return{shouldRedirect:!1,redirectTo:null,isChecking:!1}},[t,c,n,a,i,r,o.search,s.authRoute,s.roleRoute,s.tierRoute])}export{y as useBack,l as useLocation,G as useMatch,d as useNavigate,C as useParams,T as usePrefetch,$ as useQueryParams,M as useRedirectGuard,k as useRefresh,g as useSearchParams};
+"use client";import{useCallback as f}from"react";import{useRouter as h}from"next/navigation";import{isClient as S,useOverlayStore as y}from"@donotdev/core";function d(){let e=h(),t=y(r=>r.closeAll);return f((r,i)=>{if(r==="back")return t(),e.back();if(t(),i?.preserveScroll&&S()){let o=window.scrollY;i?.replace?e.replace(r):e.push(r),requestAnimationFrame(()=>{window.scrollTo({top:o,behavior:"auto"})});return}return i?.replace?e.replace(r):e.push(r)},[e,t])}function k(){let e=h();return f(()=>e.back(),[e])}function v(){let e=h();return f(()=>e.refresh(),[e])}function T(){let e=h();return f(t=>e.prefetch(t),[e])}import{usePathname as b,useSearchParams as w}from"next/navigation";function l(){let e=b(),t=w(),r=t.toString()?`?${t.toString()}`:"";return{pathname:e||"/",search:r,hash:"",state:null}}import{useParams as C}from"next/navigation";function g(){return C()}function I(e){let r=g()[e];if(typeof r=="string")return r;if(Array.isArray(r)&&r.length>0)return r[0]}import{useSearchParams as N}from"next/navigation";function R(){return N()}import{usePathname as G}from"next/navigation";function $(e){let t=G(),r=e.replace(/:[^/]+/g,"([^/]+)").replace(/\*/g,".*"),i=new RegExp(`^${r}$`),o=t.match(i);if(!o)return null;let s=e.match(/:[^/]+/g)?.map(a=>a.slice(1))||[],n={};return s.forEach((a,c)=>{n[a]=o[c+1]||""}),{params:n,pathname:t,pattern:e}}import{useCallback as P}from"react";function K(){let e=R(),t=d(),r=l(),i=P((n,a)=>{let c=new URLSearchParams(e.toString());c.set(n,a);let m=c.toString(),A=`${r.pathname||"/"}${m?`?${m}`:""}`;t(A)},[e,t,r.pathname]),o=P(n=>{let a=new URLSearchParams(e.toString());a.delete(n);let c=a.toString(),u=`${r.pathname||"/"}${c?`?${c}`:""}`;t(u)},[e,t,r.pathname]),s=P(()=>{let n=r.pathname||"/";t(n)},[t,r.pathname]);return{query:e,setQuery:i,removeQuery:o,clearQueries:s}}import{useMemo as E}from"react";import{isClient as Q,FEATURE_STATUS as F}from"@donotdev/core";import{useAuthConfig as M}from"@donotdev/core";import{DEGRADED_AUTH_API as O}from"@donotdev/core";import*as U from"@donotdev/auth";var x=U?.useAuth;function L(e){return O[e]}function p(e){return x?x(e):L(e)}function j(e={}){let{auth:t,redirectTo:r,condition:i}=e;if(!Q())return{shouldRedirect:!1,redirectTo:null,isChecking:!1};let o=l(),s=M(),n=p("user"),a=p("can"),c=p("status");return E(()=>{if(c===F.INITIALIZING)return{shouldRedirect:!1,redirectTo:null,isChecking:!0};if(i){let u=i(n,c);return{shouldRedirect:u,redirectTo:u&&r||null,isChecking:!1}}if(t!==!1&&t!==void 0){if(!a)return{shouldRedirect:!1,redirectTo:null,isChecking:!1};if(!a.navigate(t)){let u=null;return typeof t=="object"&&t.required&&!n?o.search.includes("code=")||o.search.includes("state=")||o.search.includes("error=")?u=`${s.authRoute}${o.search}`:u=s.authRoute:typeof t=="object"&&t.role?u=s.roleRoute:typeof t=="object"&&t.tier?u=s.tierRoute:u=s.roleRoute,{shouldRedirect:!0,redirectTo:r||u,isChecking:!1}}}return{shouldRedirect:!1,redirectTo:null,isChecking:!1}},[t,c,n,a,i,r,o.search,s.authRoute,s.roleRoute,s.tierRoute])}export{k as useBack,l as useLocation,$ as useMatch,d as useNavigate,g as useParams,T as usePrefetch,K as useQueryParams,j as useRedirectGuard,v as useRefresh,I as useRouteParam,R as useSearchParams};

package/dist/routing/hooks/hooks.vite.d.ts

@@ -10,6 +10,7 @@
 export { useNavigate, useBack, useRefresh, usePrefetch, } from './useNavigate.vite';
 export { useLocation } from './useLocation.vite';
 export { useParams } from './useParams.vite';
+export { useRouteParam } from './useRouteParam.vite';
 export { useSearchParams } from './useSearchParams.vite';
 export { useMatch } from './useMatch.vite';
 export { useQueryParams } from './useQueryParams.vite';

package/dist/routing/hooks/hooks.vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.vite.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/hooks.vite.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"hooks.vite.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/hooks.vite.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/routing/hooks/hooks.vite.js

@@ -1 +1 @@
-"use client";import{useCallback as m}from"react";import{useNavigate as A}from"react-router-dom";import{isClient as x,useOverlayStore as S}from"@donotdev/core";function p(){let e=A(),t=S(r=>r.closeAll);return m((r,i)=>r==="back"?(t(),e(-1)):(t(),i?.replace?e(r,{replace:!0}):e(r)),[e,t])}function y(){let e=A();return m(()=>e(-1),[e])}function v(){return m(()=>{x()&&window.location.reload()},[])}function k(){return m(e=>{},[])}import{useLocation as T}from"react-router-dom";function l(){return T()}import{useParams as C}from"react-router-dom";function I(){return C()}import{useSearchParams as b}from"react-router-dom";function d(){return b()[0]}import{useMatch as G}from"react-router-dom";function w(e){return G(e)}import{useCallback as R}from"react";function N(){let e=d(),t=p(),r=l(),i=R((n,u)=>{let a=new URLSearchParams(e.toString());a.set(n,u);let f=a.toString(),g=`${r.pathname||"/"}${f?`?${f}`:""}`;t(g)},[e,t,r.pathname]),c=R(n=>{let u=new URLSearchParams(e.toString());u.delete(n);let a=u.toString(),o=`${r.pathname||"/"}${a?`?${a}`:""}`;t(o)},[e,t,r.pathname]),s=R(()=>{let n=r.pathname||"/";t(n)},[t,r.pathname]);return{query:e,setQuery:i,removeQuery:c,clearQueries:s}}import{useMemo as U}from"react";import{isClient as $,FEATURE_STATUS as M}from"@donotdev/core";import{useAuthConfig as Q}from"@donotdev/core";import{DEGRADED_AUTH_API as K}from"@donotdev/core";import*as L from"@donotdev/auth";var P=L?.useAuth;function O(e){return K[e]}function h(e){return P?P(e):O(e)}function E(e={}){let{auth:t,redirectTo:r,condition:i}=e;if(!$())return{shouldRedirect:!1,redirectTo:null,isChecking:!1};let c=l(),s=Q(),n=h("user"),u=h("can"),a=h("status");return U(()=>{if(a===M.INITIALIZING)return{shouldRedirect:!1,redirectTo:null,isChecking:!0};if(i){let o=i(n,a);return{shouldRedirect:o,redirectTo:o&&r||null,isChecking:!1}}if(t!==!1&&t!==void 0){if(!u)return{shouldRedirect:!1,redirectTo:null,isChecking:!1};if(!u.navigate(t)){let o=null;return typeof t=="object"&&t.required&&!n?c.search.includes("code=")||c.search.includes("state=")||c.search.includes("error=")?o=`${s.authRoute}${c.search}`:o=s.authRoute:typeof t=="object"&&t.role?o=s.roleRoute:typeof t=="object"&&t.tier?o=s.tierRoute:o=s.roleRoute,{shouldRedirect:!0,redirectTo:r||o,isChecking:!1}}}return{shouldRedirect:!1,redirectTo:null,isChecking:!1}},[t,a,n,u,i,r,c.search,s.authRoute,s.roleRoute,s.tierRoute])}export{y as useBack,l as useLocation,w as useMatch,p as useNavigate,I as useParams,k as usePrefetch,N as useQueryParams,E as useRedirectGuard,v as useRefresh,d as useSearchParams};
+"use client";import{useCallback as m}from"react";import{useNavigate as P}from"react-router-dom";import{isClient as y,useOverlayStore as S}from"@donotdev/core";function h(){let e=P(),t=S(r=>r.closeAll);return m((r,i)=>r==="back"?(t(),e(-1)):(t(),i?.replace?e(r,{replace:!0}):e(r)),[e,t])}function v(){let e=P();return m(()=>e(-1),[e])}function k(){return m(()=>{y()&&window.location.reload()},[])}function T(){return m(e=>{},[])}import{useLocation as C}from"react-router-dom";function f(){return C()}import{useParams as I}from"react-router-dom";function d(){return I()}function b(e){let r=d()[e];if(typeof r=="string")return r;if(Array.isArray(r)&&r.length>0)return r[0]}import{useSearchParams as G}from"react-router-dom";function g(){return G()[0]}import{useMatch as w}from"react-router-dom";function N(e){return w(e)}import{useCallback as R}from"react";function K(){let e=g(),t=h(),r=f(),i=R((n,u)=>{let a=new URLSearchParams(e.toString());a.set(n,u);let l=a.toString(),A=`${r.pathname||"/"}${l?`?${l}`:""}`;t(A)},[e,t,r.pathname]),c=R(n=>{let u=new URLSearchParams(e.toString());u.delete(n);let a=u.toString(),o=`${r.pathname||"/"}${a?`?${a}`:""}`;t(o)},[e,t,r.pathname]),s=R(()=>{let n=r.pathname||"/";t(n)},[t,r.pathname]);return{query:e,setQuery:i,removeQuery:c,clearQueries:s}}import{useMemo as $}from"react";import{isClient as M,FEATURE_STATUS as Q}from"@donotdev/core";import{useAuthConfig as E}from"@donotdev/core";import{DEGRADED_AUTH_API as L}from"@donotdev/core";import*as O from"@donotdev/auth";var x=O?.useAuth;function U(e){return L[e]}function p(e){return x?x(e):U(e)}function _(e={}){let{auth:t,redirectTo:r,condition:i}=e;if(!M())return{shouldRedirect:!1,redirectTo:null,isChecking:!1};let c=f(),s=E(),n=p("user"),u=p("can"),a=p("status");return $(()=>{if(a===Q.INITIALIZING)return{shouldRedirect:!1,redirectTo:null,isChecking:!0};if(i){let o=i(n,a);return{shouldRedirect:o,redirectTo:o&&r||null,isChecking:!1}}if(t!==!1&&t!==void 0){if(!u)return{shouldRedirect:!1,redirectTo:null,isChecking:!1};if(!u.navigate(t)){let o=null;return typeof t=="object"&&t.required&&!n?c.search.includes("code=")||c.search.includes("state=")||c.search.includes("error=")?o=`${s.authRoute}${c.search}`:o=s.authRoute:typeof t=="object"&&t.role?o=s.roleRoute:typeof t=="object"&&t.tier?o=s.tierRoute:o=s.roleRoute,{shouldRedirect:!0,redirectTo:r||o,isChecking:!1}}}return{shouldRedirect:!1,redirectTo:null,isChecking:!1}},[t,a,n,u,i,r,c.search,s.authRoute,s.roleRoute,s.tierRoute])}export{v as useBack,f as useLocation,N as useMatch,h as useNavigate,d as useParams,T as usePrefetch,K as useQueryParams,_ as useRedirectGuard,k as useRefresh,b as useRouteParam,g as useSearchParams};

package/dist/routing/hooks/useRouteParam.next.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Safely extract a route parameter as a string
+ *
+ * Handles the fact that useParams can return string | string[] | undefined.
+ * For standard path parameters (not catch-all routes), this will always be a string.
+ *
+ * @param paramName - Name of the route parameter
+ * @returns The parameter value as a string, or undefined if not present
+ *
+ * @example
+ * ```tsx
+ * // Route: /product/:id
+ * const id = useRouteParam('id'); // string | undefined
+ * if (!id) return <NotFound />;
+ * ```
+ */
+export declare function useRouteParam(paramName: string): string | undefined;
+//# sourceMappingURL=useRouteParam.next.d.ts.map

package/dist/routing/hooks/useRouteParam.next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouteParam.next.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/useRouteParam.next.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAanE"}

package/dist/routing/hooks/useRouteParam.next.js

@@ -0,0 +1,38 @@
+'use client';
+// packages/ui/src/routing/hooks/useRouteParam.next.ts
+/**
+ * @fileoverview useRouteParam hook - Next.js implementation
+ * @description Helper hook to safely extract a single route parameter as a string
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { useParams } from './useParams.next';
+/**
+ * Safely extract a route parameter as a string
+ *
+ * Handles the fact that useParams can return string | string[] | undefined.
+ * For standard path parameters (not catch-all routes), this will always be a string.
+ *
+ * @param paramName - Name of the route parameter
+ * @returns The parameter value as a string, or undefined if not present
+ *
+ * @example
+ * ```tsx
+ * // Route: /product/:id
+ * const id = useRouteParam('id'); // string | undefined
+ * if (!id) return <NotFound />;
+ * ```
+ */
+export function useRouteParam(paramName) {
+    const params = useParams();
+    const value = params[paramName];
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value) && value.length > 0) {
+        return value[0];
+    }
+    return undefined;
+}

package/dist/routing/hooks/useRouteParam.vite.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Safely extract a route parameter as a string
+ *
+ * Handles the fact that useParams can return string | string[] | undefined.
+ * For standard path parameters (not catch-all routes), this will always be a string.
+ *
+ * @param paramName - Name of the route parameter
+ * @returns The parameter value as a string, or undefined if not present
+ *
+ * @example
+ * ```tsx
+ * // Route: /product/:id
+ * const id = useRouteParam('id'); // string | undefined
+ * if (!id) return <NotFound />;
+ * ```
+ */
+export declare function useRouteParam(paramName: string): string | undefined;
+//# sourceMappingURL=useRouteParam.vite.d.ts.map

package/dist/routing/hooks/useRouteParam.vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouteParam.vite.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/useRouteParam.vite.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAanE"}

package/dist/routing/hooks/useRouteParam.vite.js

@@ -0,0 +1,38 @@
+'use client';
+// packages/ui/src/routing/hooks/useRouteParam.vite.ts
+/**
+ * @fileoverview useRouteParam hook - Vite/React Router implementation
+ * @description Helper hook to safely extract a single route parameter as a string
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { useParams } from './useParams.vite';
+/**
+ * Safely extract a route parameter as a string
+ *
+ * Handles the fact that useParams can return string | string[] | undefined.
+ * For standard path parameters (not catch-all routes), this will always be a string.
+ *
+ * @param paramName - Name of the route parameter
+ * @returns The parameter value as a string, or undefined if not present
+ *
+ * @example
+ * ```tsx
+ * // Route: /product/:id
+ * const id = useRouteParam('id'); // string | undefined
+ * if (!id) return <NotFound />;
+ * ```
+ */
+export function useRouteParam(paramName) {
+    const params = useParams();
+    const value = params[paramName];
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value) && value.length > 0) {
+        return value[0];
+    }
+    return undefined;
+}

package/dist/routing/index.d.ts

@@ -15,7 +15,7 @@ export { default as GoToWrapper } from './GoToWrapper';
 export { default as GoToInput } from './GoToInput';
 export * from './DnDevNavigationMenu';
 export { default as NotFoundPage } from './404';
-export { useNavigate, useBack, useRefresh, usePrefetch, useLocation, useParams, useSearchParams, useMatch, useQueryParams, useRedirectGuard, } from '@donotdev/ui/routing/hooks';
+export { useNavigate, useBack, useRefresh, usePrefetch, useLocation, useParams, useRouteParam, useSearchParams, useMatch, useQueryParams, useRedirectGuard, } from '@donotdev/ui/routing/hooks';
 export type { NavigateOptions, RedirectGuardOptions, RedirectGuardResult, } from '@donotdev/ui/routing/hooks';
 export * from './useNavigation';
 export * from './useGoTo';

package/dist/routing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAGH,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAC;AAOhD,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EACf,QAAQ,EACR,cAAc,EACd,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAGH,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAC;AAOhD,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/routing/index.js

@@ -23,6 +23,6 @@ export { default as NotFoundPage } from './404';
 // - hooks.vite.ts when bundled with Vite (vite-app condition)
 // - hooks.next.ts when bundled with Next.js (default condition)
 // NOTE: Explicit named exports required - esbuild can't re-export with 'export *' from external
-export { useNavigate, useBack, useRefresh, usePrefetch, useLocation, useParams, useSearchParams, useMatch, useQueryParams, useRedirectGuard, } from '@donotdev/ui/routing/hooks';
+export { useNavigate, useBack, useRefresh, usePrefetch, useLocation, useParams, useRouteParam, useSearchParams, useMatch, useQueryParams, useRedirectGuard, } from '@donotdev/ui/routing/hooks';
 export * from './useNavigation';
 export * from './useGoTo';

package/dist/routing/useGoTo.d.ts

@@ -1,12 +1,11 @@
-import { type NavigationItem } from './useNavigation';
 /**
  * Hook for navigation with favorites and recents
  * Command component handles search/filtering
  */
 export declare const useGoTo: () => {
-    navigationItems: NavigationItem[];
-    favoriteItems: NavigationItem[];
-    recentItems: NavigationItem[];
+    navigationItems: import("./useNavigation").NavigationItem[];
+    favoriteItems: import("./useNavigation").NavigationItem[];
+    recentItems: import("./useNavigation").NavigationItem[];
     toggleFavorite: (path: string) => void;
     isFavorite: (path: string) => boolean;
     navigateToItem: (path: string) => void;

package/dist/routing/useGoTo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGoTo.d.ts","sourceRoot":"","sources":["../../src/routing/useGoTo.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAO1E;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;2BAmCT,MAAM;uBAUN,MAAM;2BAgBN,MAAM;CAehB,CAAC"}
+{"version":3,"file":"useGoTo.d.ts","sourceRoot":"","sources":["../../src/routing/useGoTo.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;2BA4BT,MAAM;uBAQN,MAAM;2BAcN,MAAM;CAehB,CAAC"}