@djangocfg/layouts 2.1.152 → 2.1.154

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/layouts",
-  "version": "2.1.152",
+  "version": "2.1.154",
   "description": "Simple, straightforward layout components for Next.js - import and use with props",
   "keywords": [
     "layouts",
@@ -74,12 +74,12 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.152",
-    "@djangocfg/centrifugo": "^2.1.152",
-    "@djangocfg/i18n": "^2.1.152",
-    "@djangocfg/ui-core": "^2.1.152",
-    "@djangocfg/ui-nextjs": "^2.1.152",
-    "@djangocfg/ui-tools": "^2.1.152",
+    "@djangocfg/api": "^2.1.154",
+    "@djangocfg/centrifugo": "^2.1.154",
+    "@djangocfg/i18n": "^2.1.154",
+    "@djangocfg/ui-core": "^2.1.154",
+    "@djangocfg/ui-nextjs": "^2.1.154",
+    "@djangocfg/ui-tools": "^2.1.154",
     "@hookform/resolvers": "^5.2.2",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
@@ -102,13 +102,13 @@
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.152",
-    "@djangocfg/i18n": "^2.1.152",
-    "@djangocfg/centrifugo": "^2.1.152",
-    "@djangocfg/typescript-config": "^2.1.152",
-    "@djangocfg/ui-core": "^2.1.152",
-    "@djangocfg/ui-nextjs": "^2.1.152",
-    "@djangocfg/ui-tools": "^2.1.152",
+    "@djangocfg/api": "^2.1.154",
+    "@djangocfg/i18n": "^2.1.154",
+    "@djangocfg/centrifugo": "^2.1.154",
+    "@djangocfg/typescript-config": "^2.1.154",
+    "@djangocfg/ui-core": "^2.1.154",
+    "@djangocfg/ui-nextjs": "^2.1.154",
+    "@djangocfg/ui-tools": "^2.1.154",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",

package/src/components/errors/ErrorsTracker/components/ErrorToast.tsx

@@ -64,7 +64,7 @@ function buildValidationDescription(
  */
 function buildCORSDescription(
   detail: CORSErrorDetail,
-  config: Required<CORSErrorConfig>
+  _config: Required<CORSErrorConfig>
 ): React.ReactNode {
   const domain = extractDomain(detail.url);
 

package/src/components/errors/ErrorsTracker/providers/ErrorTrackingProvider.tsx

@@ -44,7 +44,6 @@ import {
 import type {
   ErrorDetail,
   StoredError,
-  ErrorTrackingConfig,
   ValidationErrorConfig,
   CORSErrorConfig,
   NetworkErrorConfig,
@@ -198,7 +197,7 @@ export function ErrorTrackingProvider({
   /**
    * Clear errors by type
    */
-  const clearErrorsByType = useCallback((type: 'validation' | 'cors' | 'network') => {
+  const clearErrorsByType = useCallback((type: 'validation' | 'cors' | 'network' | 'centrifugo') => {
     setErrors((prev) => prev.filter((error) => error.type !== type));
   }, []);
 

package/src/components/errors/errorConfig.ts

@@ -13,7 +13,8 @@ export interface ErrorContent {
   description: string;
 }
 
-type TranslationFn = (key: string, params?: Record<string, string | number>) => string;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type TranslationFn = (key: any, params?: Record<string, string | number>) => string;
 
 /**
  * Get standardized error content based on status code

package/src/layouts/AppLayout/AppLayout.tsx

@@ -36,6 +36,7 @@ import React, { ReactNode, useMemo } from 'react';
 
 import { ClientOnly, Suspense } from '../../components/core';
 import { usePathnameWithoutLocale } from '../../hooks';
+import { matchesPath } from '../../utils/pathMatcher';
 import { BaseApp } from './BaseApp';
 
 import type {
@@ -52,20 +53,6 @@ import type { AuthConfig } from '@djangocfg/api/auth';
 
 export type LayoutMode = 'public' | 'private' | 'admin';
 
-/**
- * Check if pathname matches enabledPath
- */
-function matchesPath(pathname: string, enabledPath?: string | string[]): boolean {
-  if (!enabledPath) return false;
-
-  if (typeof enabledPath === 'string') {
-    return pathname === enabledPath || pathname.startsWith(enabledPath + '/');
-  }
-
-  // Array of paths
-  return enabledPath.some(path => pathname === path || pathname.startsWith(path + '/'));
-}
-
 /**
  * Determine layout mode from pathname and enabledPath props
  */

package/src/layouts/AuthLayout/components/oauth/OAuthCallback.tsx

@@ -66,7 +66,7 @@ export const OAuthCallback: React.FC<OAuthCallbackProps> = ({
 
   const {
     handleGithubCallback,
-    isLoading,
+    isLoading: _isLoading,
     error: githubError,
   } = useGithubAuth({
     onSuccess: (user, isNewUser) => {

package/src/layouts/AuthLayout/components/steps/SetupStep/SetupComplete.tsx

@@ -10,7 +10,7 @@ import { AuthButton, AuthContainer, AuthHeader } from '../../shared';
 
 interface SetupCompleteProps {
   backupCodes: string[];
-  backupCodesWarning?: string;
+  backupCodesWarning?: string | null;
   onDone: () => void;
 }
 

package/src/layouts/AuthLayout/components/steps/SetupStep/SetupQRCode.tsx

@@ -26,7 +26,7 @@ interface SetupQRCodeProps {
   provisioningUri: string;
   secret: string;
   isLoading: boolean;
-  error?: string;
+  error?: string | null;
   onConfirm: (code: string) => Promise<unknown>;
   onSkip?: () => void;
 }

package/src/layouts/PrivateLayout/components/PrivateHeader.tsx

@@ -26,7 +26,7 @@ interface PrivateHeaderProps {
 }
 
 export function PrivateHeader({ header, i18n }: PrivateHeaderProps) {
-  const { user, logout } = useAuth();
+  const { user } = useAuth();
 
   return (
     <header

package/src/layouts/PrivateLayout/components/PrivateSidebar.tsx

@@ -18,7 +18,7 @@ import { cn } from '@djangocfg/ui-core/lib';
 
 import { LucideIcon } from '../../../components';
 
-import type { SidebarItem, SidebarConfig, SidebarGroupConfig } from '../PrivateLayout';
+import type { SidebarItem, SidebarConfig } from '../PrivateLayout';
 
 interface PrivateSidebarProps {
   sidebar: SidebarConfig;

package/src/layouts/ProfileLayout/ProfileLayout.tsx

@@ -45,7 +45,8 @@ interface ProfileLayoutProps {
   enableDeleteAccount?: boolean;
 }
 
-type EditingField = 'first_name' | 'last_name' | 'company' | 'position' | 'phone' | null;
+// Reserved for future use
+// type EditingField = 'first_name' | 'last_name' | 'company' | 'position' | 'phone' | null;
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Editable Field Component
@@ -201,7 +202,7 @@ const ProfileContent = ({
   enable2FA = false,
   enableDeleteAccount = true,
 }: ProfileLayoutProps) => {
-  const { user, isLoading, logout, uploadAvatar, updateProfile } = useAuth();
+  const { user, isLoading, uploadAvatar, updateProfile } = useAuth();
   const [isUploading, setIsUploading] = useState(false);
   const t = useTypedT<I18nTranslations>();
 

package/src/layouts/PublicLayout/components/PublicMobileDrawer.tsx

@@ -13,7 +13,7 @@ import React, { useMemo } from 'react';
 import { useAuth } from '@djangocfg/api/auth';
 import { useTypedT, type I18nTranslations } from '@djangocfg/i18n';
 import {
-    Button, Drawer, DrawerClose, DrawerContent, DrawerHeader, DrawerTitle
+    Drawer, DrawerClose, DrawerContent, DrawerHeader, DrawerTitle
 } from '@djangocfg/ui-core/components';
 import { ThemeToggle } from '@djangocfg/ui-nextjs/theme';
 
@@ -38,7 +38,7 @@ export function PublicMobileDrawer({
   navigation,
   userMenu,
 }: PublicMobileDrawerProps) {
-  const { isAuthenticated } = useAuth();
+  const { isAuthenticated: _isAuthenticated } = useAuth();
   const t = useTypedT<I18nTranslations>();
 
   const labels = useMemo(() => ({

package/src/layouts/PublicLayout/components/PublicNavigation.tsx

@@ -13,6 +13,7 @@ import React, { useMemo } from 'react';
 import { useAuth } from '@djangocfg/api/auth';
 import { useTypedT, type I18nTranslations } from '@djangocfg/i18n';
 import { Button } from '@djangocfg/ui-core/components';
+// useIsMobile is used for conditional rendering
 import { useIsMobile } from '@djangocfg/ui-core/hooks';
 import { cn } from '@djangocfg/ui-core/lib';
 import { ThemeToggle } from '@djangocfg/ui-nextjs/theme';
@@ -41,7 +42,7 @@ export function PublicNavigation({
   onMobileMenuClick,
   i18n,
 }: PublicNavigationProps) {
-  const { isAuthenticated } = useAuth();
+  const { isAuthenticated: _isAuthenticated } = useAuth();
   const isMobile = useIsMobile();
   const t = useTypedT<I18nTranslations>();
 

package/src/snippets/Analytics/useAnalytics.ts

@@ -19,7 +19,7 @@ const isProduction = process.env.NODE_ENV === 'production';
 
 // Tracking state
 let isInitialized = false;
-let currentTrackingId: string | undefined;
+let _currentTrackingId: string | undefined;
 
 /**
  * Analytics utility object for standalone usage (outside React components)
@@ -40,7 +40,7 @@ export const Analytics = {
     if (!isProduction || !trackingId || isInitialized) return;
     ReactGA.initialize(trackingId);
     isInitialized = true;
-    currentTrackingId = trackingId;
+    _currentTrackingId = trackingId;
   },
 
   /**

package/src/snippets/PWAInstall/components/DesktopGuide.tsx

@@ -33,7 +33,7 @@ function getBrowserCategory(browser: {
   return 'unknown';
 }
 
-type TranslationFn = (key: string) => string;
+type TranslationFn = (key: any) => string;
 
 function getBrowserSteps(category: BrowserCategory, t: TranslationFn): InstallStep[] {
   switch (category) {

package/src/utils/index.ts

@@ -4,4 +4,5 @@
 
 export * from './config';
 export * from './logger';
+export * from './pathMatcher';
 

package/src/utils/pathMatcher.ts

@@ -0,0 +1,118 @@
+/**
+ * Path Matcher Utility
+ *
+ * Functions for matching URL paths against patterns with glob support.
+ */
+
+/**
+ * Match pathname against glob pattern
+ *
+ * @param pathname - The URL pathname to match (e.g., '/projects/123/edit')
+ * @param pattern - The pattern to match against (e.g., '/projects/*/edit')
+ * @returns true if pathname matches the pattern
+ *
+ * Glob patterns:
+ * - '*' matches any single path segment
+ * - '**' matches any number of path segments (zero or more)
+ *
+ * @example
+ * matchGlobPattern('/projects/123/edit', '/projects/*/edit') // true
+ * matchGlobPattern('/projects/abc/edit', '/projects/*/edit') // true
+ * matchGlobPattern('/admin/users/1/settings', '/admin/**') // true
+ * matchGlobPattern('/projects/edit', '/projects/*/edit') // false
+ */
+export function matchGlobPattern(pathname: string, pattern: string): boolean {
+  // Normalize paths (remove trailing slashes)
+  const normalizedPath = pathname.replace(/\/+$/, '');
+  const normalizedPattern = pattern.replace(/\/+$/, '');
+
+  // Split into segments
+  const pathParts = normalizedPath.split('/').filter(Boolean);
+  const patternParts = normalizedPattern.split('/').filter(Boolean);
+
+  let pathIdx = 0;
+  let patternIdx = 0;
+
+  while (patternIdx < patternParts.length && pathIdx < pathParts.length) {
+    const patternPart = patternParts[patternIdx];
+
+    if (patternPart === '**') {
+      // '**' matches zero or more segments
+      // If it's the last pattern part, it matches everything remaining
+      if (patternIdx === patternParts.length - 1) {
+        return true;
+      }
+      // Otherwise, try to match the next pattern part against remaining path parts
+      const nextPatternPart = patternParts[patternIdx + 1];
+      while (pathIdx < pathParts.length) {
+        if (pathParts[pathIdx] === nextPatternPart || nextPatternPart === '*') {
+          break;
+        }
+        pathIdx++;
+      }
+      patternIdx++;
+    } else if (patternPart === '*') {
+      // '*' matches exactly one segment
+      pathIdx++;
+      patternIdx++;
+    } else {
+      // Literal match
+      if (pathParts[pathIdx] !== patternPart) {
+        return false;
+      }
+      pathIdx++;
+      patternIdx++;
+    }
+  }
+
+  // Check if we've consumed both arrays
+  // Pattern can have trailing '**' which matches empty
+  if (patternIdx < patternParts.length) {
+    // Remaining pattern parts must all be '**'
+    for (let i = patternIdx; i < patternParts.length; i++) {
+      if (patternParts[i] !== '**') {
+        return false;
+      }
+    }
+  }
+
+  return pathIdx === pathParts.length;
+}
+
+/**
+ * Check if pathname matches any of the enabled paths
+ *
+ * @param pathname - The URL pathname to check
+ * @param enabledPath - Single path, array of paths, or undefined
+ * @returns true if pathname matches any enabled path
+ *
+ * Supports:
+ * - Exact match: '/dashboard' matches '/dashboard'
+ * - Prefix match: '/dashboard' matches '/dashboard/settings'
+ * - Glob patterns: '/projects/*\/edit' matches '/projects/123/edit'
+ *
+ * @example
+ * matchesPath('/dashboard', '/dashboard') // true
+ * matchesPath('/dashboard/settings', '/dashboard') // true
+ * matchesPath('/projects/123/edit', '/projects/*\/edit') // true
+ * matchesPath('/home', ['/dashboard', '/admin']) // false
+ */
+export function matchesPath(pathname: string, enabledPath?: string | string[]): boolean {
+  if (!enabledPath) return false;
+
+  const matchSinglePath = (path: string): boolean => {
+    // If pattern contains glob characters, use pattern matching
+    if (path.includes('*')) {
+      return matchGlobPattern(pathname, path);
+    }
+    // Otherwise, exact or prefix match
+    return pathname === path || pathname.startsWith(path + '/');
+  };
+
+  if (typeof enabledPath === 'string') {
+    return matchSinglePath(enabledPath);
+  }
+
+  // Array of paths
+  return enabledPath.some(matchSinglePath);
+}