@donotdev/ui 0.0.12 → 0.0.14

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

@@ -24,14 +24,7 @@ import { useAuthSafe } from '../../utils/useAuthSafe';
  */
 export function useRedirectGuard(options = {}) {
     const { auth, redirectTo: customRedirectTo, condition } = options;
-    // SSR-safe: return safe defaults on server
-    if (!isClient()) {
-        return {
-            shouldRedirect: false,
-            redirectTo: null,
-            isChecking: false,
-        };
-    }
+    // Hooks must be called unconditionally (Rules of Hooks)
     const location = useLocation();
     const authConfig = useAuthConfig();
     const user = useAuthSafe('user');
@@ -39,6 +32,14 @@ export function useRedirectGuard(options = {}) {
     const status = useAuthSafe('status');
     // Determine redirect state
     const redirectState = useMemo(() => {
+        // SSR-safe: return safe defaults on server
+        if (!isClient()) {
+            return {
+                shouldRedirect: false,
+                redirectTo: null,
+                isChecking: false,
+            };
+        }
         // Only INITIALIZING = still checking. DEGRADED/ERROR/READY = auth resolved (proceed with current user)
         if (status === FEATURE_STATUS.INITIALIZING) {
             return {

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

@@ -1,2 +1,19 @@
-export declare function useSearchParams(): import("next/navigation").ReadonlyURLSearchParams;
+import { useSearchParams as useNextSearchParams } from 'next/navigation';
+/**
+ * Get current URL search parameters (read-only).
+ * Returns a ReadonlyURLSearchParams instance directly (NOT a tuple).
+ *
+ * To modify search params, use `useNavigate()` with a query string
+ * or `useQueryParams()` for a key-value API with defaults.
+ *
+ * @returns ReadonlyURLSearchParams instance with `.get()`, `.has()`, `.getAll()`, etc.
+ *
+ * @example
+ * ```tsx
+ * const searchParams = useSearchParams();
+ * const page = searchParams.get('page');
+ * const sort = searchParams.get('sort');
+ * ```
+ */
+export declare function useSearchParams(): ReturnType<typeof useNextSearchParams>;
 //# sourceMappingURL=useSearchParams.next.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useSearchParams.next.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/useSearchParams.next.ts"],"names":[],"mappings":"AAKA,wBAAgB,eAAe,sDAE9B"}
+{"version":3,"file":"useSearchParams.next.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/useSearchParams.next.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAExE"}

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

@@ -1,6 +1,22 @@
 'use client';
 // packages/ui/src/routing/hooks/useSearchParams.next.ts
 import { useSearchParams as useNextSearchParams } from 'next/navigation';
+/**
+ * Get current URL search parameters (read-only).
+ * Returns a ReadonlyURLSearchParams instance directly (NOT a tuple).
+ *
+ * To modify search params, use `useNavigate()` with a query string
+ * or `useQueryParams()` for a key-value API with defaults.
+ *
+ * @returns ReadonlyURLSearchParams instance with `.get()`, `.has()`, `.getAll()`, etc.
+ *
+ * @example
+ * ```tsx
+ * const searchParams = useSearchParams();
+ * const page = searchParams.get('page');
+ * const sort = searchParams.get('sort');
+ * ```
+ */
 export function useSearchParams() {
     return useNextSearchParams();
 }

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

@@ -1,2 +1,18 @@
+/**
+ * Get current URL search parameters (read-only).
+ * Returns a URLSearchParams instance directly (NOT a tuple).
+ *
+ * To modify search params, use `useNavigate()` with a query string
+ * or `useQueryParams()` for a key-value API with defaults.
+ *
+ * @returns URLSearchParams instance with `.get()`, `.has()`, `.getAll()`, etc.
+ *
+ * @example
+ * ```tsx
+ * const searchParams = useSearchParams();
+ * const page = searchParams.get('page');
+ * const sort = searchParams.get('sort');
+ * ```
+ */
 export declare function useSearchParams(): URLSearchParams;
 //# sourceMappingURL=useSearchParams.vite.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useSearchParams.vite.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/useSearchParams.vite.ts"],"names":[],"mappings":"AAKA,wBAAgB,eAAe,oBAE9B"}
+{"version":3,"file":"useSearchParams.vite.d.ts","sourceRoot":"","sources":["../../../src/routing/hooks/useSearchParams.vite.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAEjD"}

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

@@ -1,6 +1,22 @@
 'use client';
 // packages/ui/src/routing/hooks/useSearchParams.vite.ts
 import { useSearchParams as useRouterSearchParams } from 'react-router-dom';
+/**
+ * Get current URL search parameters (read-only).
+ * Returns a URLSearchParams instance directly (NOT a tuple).
+ *
+ * To modify search params, use `useNavigate()` with a query string
+ * or `useQueryParams()` for a key-value API with defaults.
+ *
+ * @returns URLSearchParams instance with `.get()`, `.has()`, `.getAll()`, etc.
+ *
+ * @example
+ * ```tsx
+ * const searchParams = useSearchParams();
+ * const page = searchParams.get('page');
+ * const sort = searchParams.get('sort');
+ * ```
+ */
 export function useSearchParams() {
-    return useRouterSearchParams()[0]; // React Router returns [searchParams, setSearchParams]
+    return useRouterSearchParams()[0];
 }

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAGH,cAAc,QAAQ,CAAC;AAGvB,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

@@ -10,6 +10,8 @@
  */
 // Components - all platform-agnostic
 export * from './Link';
+// NavigationItemComponent intentionally NOT exported — internal building block.
+// Public API: HeaderNavigation (path prop for single item), DnDevNavigationMenu (full menu).
 export * from './AuthGuard';
 export * from './AuthGuardFallback';
 export * from './GoTo';

package/dist/routing/useNavigation.d.ts

@@ -30,4 +30,34 @@ export interface NavigationItem extends NavigationRoute {
  * ```
  */
 export declare function useNavigationItems(): NavigationItem[];
+/**
+ * Resolves a single navigation item from the store by path.
+ *
+ * Returns `undefined` if the path is not registered or the user lacks access.
+ * Use this to compose a standalone Button-style nav link without reaching for
+ * a full NavigationMenu.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ *
+ * @example
+ * ```tsx
+ * const route = useNavigationRoute('/pricing');
+ * if (!route) return null;
+ * return (
+ *   <Button
+ *     variant="ghost"
+ *     display={DISPLAY.AUTO}
+ *     icon={<Icon icon={route.icon} fallback={LinkIcon} />}
+ *     render={({ children, ...props }) => (
+ *       <Link path={route.path} {...props}>{children}</Link>
+ *     )}
+ *   >
+ *     {route.label}
+ *   </Button>
+ * );
+ * ```
+ */
+export declare function useNavigationRoute(path: string): NavigationItem | undefined;
 //# sourceMappingURL=useNavigation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useNavigation.d.ts","sourceRoot":"","sources":["../../src/routing/useNavigation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQtD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CA0CrD"}
+{"version":3,"file":"useNavigation.d.ts","sourceRoot":"","sources":["../../src/routing/useNavigation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQtD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAgDrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG3E"}

package/dist/routing/useNavigation.js

@@ -42,7 +42,9 @@ export function useNavigationItems() {
     const filteredRoutes = useNavigationStore((state) => {
         // Guard against undefined state during initialization
         if (!state || typeof state.getFilteredRoutes !== 'function') {
-            console.warn('[useNavigationItems] Navigation store not initialized, returning empty routes');
+            if (process.env.NODE_ENV === 'development') {
+                console.warn('[useNavigationItems] Navigation store not initialized, returning empty routes');
+            }
             return [];
         }
         return state.getFilteredRoutes({
@@ -53,7 +55,9 @@ export function useNavigationItems() {
     return useMemo(() => {
         // Ensure filteredRoutes is always an array
         if (!Array.isArray(filteredRoutes)) {
-            console.warn('[useNavigationItems] filteredRoutes is not an array:', filteredRoutes);
+            if (process.env.NODE_ENV === 'development') {
+                console.warn('[useNavigationItems] filteredRoutes is not an array:', filteredRoutes);
+            }
             return [];
         }
         return filteredRoutes
@@ -63,9 +67,42 @@ export function useNavigationItems() {
             hasChildren: false,
             children: undefined,
         }))
-            .sort((a, b) => a.label.localeCompare(b.label)); // Alphabetical sorting by label
+            .sort((a, b) => a.label.localeCompare(b.label, undefined, { sensitivity: 'base' })); // Alphabetical sorting by label
     }, [filteredRoutes, location.pathname]);
 }
+/**
+ * Resolves a single navigation item from the store by path.
+ *
+ * Returns `undefined` if the path is not registered or the user lacks access.
+ * Use this to compose a standalone Button-style nav link without reaching for
+ * a full NavigationMenu.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ *
+ * @example
+ * ```tsx
+ * const route = useNavigationRoute('/pricing');
+ * if (!route) return null;
+ * return (
+ *   <Button
+ *     variant="ghost"
+ *     display={DISPLAY.AUTO}
+ *     icon={<Icon icon={route.icon} fallback={LinkIcon} />}
+ *     render={({ children, ...props }) => (
+ *       <Link path={route.path} {...props}>{children}</Link>
+ *     )}
+ *   >
+ *     {route.label}
+ *   </Button>
+ * );
+ * ```
+ */
+export function useNavigationRoute(path) {
+    const items = useNavigationItems();
+    return useMemo(() => items.find((item) => item.path === path), [items, path]);
+}
 // ===== HELPER FUNCTIONS =====
 /**
  * Determines if a route path is currently active

package/dist/routing/useRouteDiscovery.d.ts

@@ -21,9 +21,9 @@ export interface RouteInfo {
     /** Export name for named exports (e.g., 'HomePage', 'AboutPage') */
     exportName?: string;
     /** Authentication configuration for the route */
-    auth?: any;
+    auth?: boolean | Record<string, unknown>;
     /** Additional route metadata */
-    meta?: any;
+    meta?: unknown;
 }
 /**
  * Group of related routes organized by entity/domain

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

@@ -1 +1 @@
-{"version":3,"file":"useRouteDiscovery.d.ts","sourceRoot":"","sources":["../../src/routing/useRouteDiscovery.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,gCAAgC;IAChC,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACnB,qCAAqC;IACrC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAuBhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,EAAE,CAmBlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,6BAA6B,IAAI,eAAe,EAAE,CAgBjE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,gBAK3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB;;;;;;SAQ/B"}
+{"version":3,"file":"useRouteDiscovery.d.ts","sourceRoot":"","sources":["../../src/routing/useRouteDiscovery.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACnB,qCAAqC;IACrC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CA2BhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,EAAE,CAmBlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,6BAA6B,IAAI,eAAe,EAAE,CAgBjE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,gBAK3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB;;;;;;SAQ/B"}

package/dist/routing/useRouteDiscovery.js

@@ -56,15 +56,19 @@ export function useRouteDiscovery() {
         try {
             const routeData = getRoutes();
             if (!routeData || routeData.length === 0) {
-                console.warn('🛣️ [useRouteDiscovery] No routes found - ensure you have *Page.tsx files in src/');
+                if (process.env.NODE_ENV === 'development') {
+                    console.warn('[useRouteDiscovery] No routes found - ensure you have *Page.tsx files in src/');
+                }
                 return [];
             }
             const groupedRoutes = groupRoutes(routeData);
             return groupedRoutes;
         }
         catch (error) {
-            console.error('🛣️ [useRouteDiscovery] Error discovering routes:', error);
-            console.warn('🛣️ [useRouteDiscovery] No routes found - ensure you have *Page.tsx files in src/');
+            if (process.env.NODE_ENV === 'development') {
+                console.error('[useRouteDiscovery] Error discovering routes:', error);
+                console.warn('[useRouteDiscovery] No routes found - ensure you have *Page.tsx files in src/');
+            }
             return [];
         }
     }, []);
@@ -246,7 +250,9 @@ function groupRoutes(routes) {
         const pathString = typeof route.path === 'string' ? route.path : String(route.path);
         // Skip invalid routes
         if (!pathString || pathString === 'undefined' || pathString === 'null') {
-            console.warn('[groupRoutes] Skipping invalid route:', route);
+            if (process.env.NODE_ENV === 'development') {
+                console.warn('[groupRoutes] Skipping invalid route:', route);
+            }
             return;
         }
         // Extract entity with fallback to path-based detection