@djangocfg/layouts 2.1.39 → 2.1.40

package/README.md

@@ -102,6 +102,9 @@ export default function RootLayout({ children }) {
             component: AdminLayout,
             enabledPath: '/admin'
           }}
+
+          // Skip layout for fullscreen pages (providers still applied)
+          noLayoutPaths={['/private/terminal', '/embed']}
         >
           {children}
         </AppLayout>
@@ -113,6 +116,8 @@ export default function RootLayout({ children }) {
 
 **Layout priority:** Admin → Private → Public → Fallback
 
+**noLayoutPaths:** Paths that render without any layout wrapper. Useful for fullscreen pages (terminal, embed, print). Providers (auth, theme, centrifugo) are still applied.
+
 ## Layouts
 
 Simple, props-based layout components. No complex configs needed!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/layouts",
-  "version": "2.1.39",
+  "version": "2.1.40",
   "description": "Simple, straightforward layout components for Next.js - import and use with props",
   "keywords": [
     "layouts",
@@ -92,9 +92,9 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.39",
-    "@djangocfg/centrifugo": "^2.1.39",
-    "@djangocfg/ui-nextjs": "^2.1.39",
+    "@djangocfg/api": "^2.1.40",
+    "@djangocfg/centrifugo": "^2.1.40",
+    "@djangocfg/ui-nextjs": "^2.1.40",
     "@hookform/resolvers": "^5.2.0",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
@@ -114,7 +114,7 @@
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@djangocfg/typescript-config": "^2.1.39",
+    "@djangocfg/typescript-config": "^2.1.40",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",

package/src/layouts/AppLayout/AppLayout.tsx

@@ -1,33 +1,29 @@
 /**
  * AppLayout - Smart Layout Router with All Providers
- * 
+ *
  * Automatically detects route type and applies the correct layout
  * Includes all necessary providers: Theme, Auth, Analytics, Centrifugo, Error Tracking
  * Simple props-based configuration - no complex configs needed!
- * 
+ *
  * @example
  * ```tsx
  * import { AppLayout } from '@djangocfg/layouts';
- * 
+ *
  * <AppLayout
  *   publicLayout={{
- *     logo: '/logo.svg',
- *     siteName: 'My App',
- *     navigation: [{ label: 'Home', href: '/' }]
+ *     component: PublicLayout,
+ *     enabledPath: ['/', '/about', '/contact']
  *   }}
  *   privateLayout={{
- *     enabledPath: ['/dashboard', '/profile'],
- *     sidebar: { items: [{ label: 'Dashboard', href: '/dashboard' }] }
- *   }}
- *   authLayout={{
- *     enabledPath: '/auth',
- *     logo: '/logo.svg',
- *     siteName: 'My App'
+ *     component: DashboardLayout,
+ *     enabledPath: '/dashboard'
  *   }}
  *   adminLayout={{
- *     enabledPath: '/admin',
- *     sidebar: { items: [{ label: 'Admin', href: '/admin' }] }
+ *     component: AdminLayout,
+ *     enabledPath: '/admin'
  *   }}
+ *   // Paths that render without any layout wrapper (fullscreen pages)
+ *   noLayoutPaths={['/private/terminal', '/embed']}
  * >
  *   {children}
  * </AppLayout>
@@ -108,6 +104,13 @@ export interface AppLayoutProps {
     enabledPath?: string | string[];
   };
 
+  /**
+   * Paths that render without any layout wrapper (fullscreen pages)
+   * Providers (auth, theme, etc.) are still applied, only layout is skipped
+   * Useful for: fullscreen terminal, embed pages, print views
+   */
+  noLayoutPaths?: string | string[];
+
   /** Theme configuration */
   theme?: ThemeConfig;
 
@@ -150,11 +153,16 @@ function AppLayoutContent({
   publicLayout,
   privateLayout,
   adminLayout,
-  analytics,
-  centrifugo,
+  noLayoutPaths,
 }: AppLayoutProps) {
   const pathname = usePathname();
 
+  // Check if current path should skip layout
+  const shouldSkipLayout = useMemo(
+    () => matchesPath(pathname, noLayoutPaths),
+    [pathname, noLayoutPaths]
+  );
+
   const layoutMode = useMemo(
     () => determineLayoutMode(
       pathname,
@@ -167,6 +175,11 @@ function AppLayoutContent({
 
   // Render appropriate layout based on mode
   const renderLayout = () => {
+    // Skip layout for noLayoutPaths (fullscreen pages)
+    if (shouldSkipLayout) {
+      return children;
+    }
+
     switch (layoutMode) {
       case 'admin':
         if (!adminLayout && privateLayout) {