@donotdev/ui 0.0.13 → 0.0.15

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

@@ -1,3 +1,4 @@
+import type { NavigationRoute as CoreNavigationRoute } from '@donotdev/core';
 import type { JSX } from 'react';
 import type { ReactNode } from 'react';
 /**
@@ -21,9 +22,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
@@ -41,22 +42,10 @@ export interface RouteGroup {
     routes: RouteInfo[];
 }
 /**
- * Navigation route interface for UI components
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
+ * Navigation route - re-exported from @donotdev/core (Item 90)
+ * Core's version is the single source of truth with richer fields.
  */
-export interface NavigationRoute {
-    /** Route path */
-    path: string;
-    /** Display label */
-    label: string;
-    /** Optional icon component */
-    icon?: ReactNode;
-    /** Additional route metadata */
-    meta?: any;
-}
+export type NavigationRoute = CoreNavigationRoute;
 /**
  * Hook that provides auto-discovered routes from virtual module system
  *

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":"AAiCA,OAAO,KAAK,EAAsB,eAAe,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIjG,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;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CA2BhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,EAAE,CAoBlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,6BAA6B,IAAI,eAAe,EAAE,CAcjE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,gBAK3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB;;;;;;SAQ/B"}

package/dist/routing/useRouteDiscovery.js

@@ -23,7 +23,7 @@
  * ```
  */
 import { useMemo } from 'react';
-import { useNavigationStore, getRoutes, getRouteManifest, buildRoutePath, } from '@donotdev/core';
+import { useNavigationStore, getRoutes, getRouteManifest, } from '@donotdev/core';
 import { useAuthSafe } from '../utils/useAuthSafe';
 /**
  * Hook that provides auto-discovered routes from virtual module system
@@ -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 [];
         }
     }, []);
@@ -104,9 +108,11 @@ export function useAccessibleRoutes() {
             .map((group) => ({
             ...group,
             routes: group.routes.filter((route) => {
-                // Use same filtering logic as AuthGuard for consistency
+                // Use same filtering logic as AuthGuard for consistency (Item 88)
                 if (route.auth === false)
                     return true;
+                if (route.auth === true)
+                    return !!user;
                 if (typeof route.auth === 'object' && route.auth.required) {
                     return !!user;
                 }
@@ -145,9 +151,8 @@ export function useAccessibleRoutes() {
  */
 export function useAccessibleNavigationRoutes() {
     const user = useAuthSafe('user');
-    const { getFilteredRoutes } = useNavigationStore();
     return useMemo(() => {
-        const filteredRoutes = getFilteredRoutes({
+        const filteredRoutes = useNavigationStore.getState().getFilteredRoutes({
             authenticated: !!user,
             role: user?.role || 'user',
         });
@@ -157,7 +162,7 @@ export function useAccessibleNavigationRoutes() {
             icon: route.icon,
             meta: route.meta,
         }));
-    }, [getFilteredRoutes, user]);
+    }, [user]);
 }
 /**
  * Hook that returns all discovered routes as a flat list
@@ -246,7 +251,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