@djangocfg/layouts 1.0.1

package/src/types/pageConfig.ts

@@ -0,0 +1,103 @@
+import { FC, ReactNode } from 'react';
+
+// Configuration for the AppBar
+export interface AppBarConfig {
+  label?: string;
+  showSidebarToggle?: boolean;
+  onSidebarToggle?: () => void;
+  hideAuthButtons?: boolean;
+  hideNavigation?: boolean;
+  actions?: ReactNode;
+  showPageScrollProgress?: boolean;
+}
+
+// OpenGraph configuration
+export interface OpenGraphConfig {
+  title?: string;
+  description?: string;
+  type?: string;
+  images?: Array<{
+    url: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+  }>;
+  siteName?: string;
+  locale?: string;
+}
+
+// Twitter configuration
+export interface TwitterConfig {
+  card?: 'summary' | 'summary_large_image' | 'app' | 'player';
+  title?: string;
+  description?: string;
+  images?: string[];
+  creator?: string;
+  site?: string;
+}
+
+// Configuration for a Page using the App3 layout
+export interface PageConfig {
+  projectName?: string;
+  title?: string;
+  description?: string;
+  keywords?: string;
+  jsonLd?: Record<string, any>;
+  appBar?: AppBarConfig;
+  protected?: boolean;
+  themeMode?: 'light' | 'dark';
+  ogImage?: {
+    title?: string;
+    subtitle?: string;
+  };
+  openGraph?: OpenGraphConfig;
+  twitter?: TwitterConfig;
+}
+
+// Type for a Page component that includes page configuration
+export type PageWithConfig<T = {}> = FC<T> & {
+  pageConfig?: PageConfig;
+  [key: string]: any;
+};
+
+// --- Helper Function ---
+export const determinePageConfig = (
+  Component: PageWithConfig,
+  pageProps: Record<string, any>, // Use a general type for pageProps
+  defaultTitle?: string,
+  defaultDescription?: string,
+): PageConfig => {
+  const defaultPageConfig: PageConfig = {
+    title: defaultTitle,
+    description: defaultDescription,
+    protected: false,
+  };
+
+  const configFromProps = pageProps.pageConfig as PageConfig | undefined;
+  const configFromStatic = Component.pageConfig as PageConfig | undefined;
+
+  let finalConfig: PageConfig = { ...defaultPageConfig };
+
+  // Merge static config first
+  if (configFromStatic) {
+    finalConfig = {
+      ...finalConfig,
+      ...configFromStatic,
+    };
+  }
+
+  // Merge dynamic config from props (overrides static)
+  if (configFromProps) {
+    finalConfig = {
+      ...finalConfig,
+      ...configFromProps,
+      appBar: {
+        ...finalConfig.appBar,
+        ...configFromProps.appBar,
+      },
+    };
+  }
+
+  return finalConfig;
+};
+// --- End Helper Function ---

package/src/utils/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Utils - Utility functions and helpers
+ */
+
+export * from './logger';
+

package/src/utils/logger.ts

@@ -0,0 +1,57 @@
+import { createConsola } from 'consola';
+
+/**
+ * Universal logger for @djangocfg/layouts
+ * Uses consola for beautiful console logging
+ * 
+ * Log levels:
+ * - 0: silent
+ * - 1: fatal, error
+ * - 2: warn
+ * - 3: log, info
+ * - 4: debug
+ * - 5: trace, verbose
+ */
+export const logger = createConsola({
+  level: process.env.NODE_ENV === 'production' ? 3 : 4,
+}).withTag('layouts');
+
+// ─────────────────────────────────────────────────────────────────────────
+// Module-specific loggers
+// ─────────────────────────────────────────────────────────────────────────
+
+/**
+ * Auth-specific logger
+ */
+export const authLogger = logger.withTag('auth');
+
+/**
+ * Chat-specific logger
+ */
+export const chatLogger = logger.withTag('chat');
+
+/**
+ * Support-specific logger
+ */
+export const supportLogger = logger.withTag('support');
+
+/**
+ * Payments-specific logger
+ */
+export const paymentsLogger = logger.withTag('payments');
+
+/**
+ * Profile-specific logger
+ */
+export const profileLogger = logger.withTag('profile');
+
+/**
+ * Dashboard-specific logger
+ */
+export const dashboardLogger = logger.withTag('dashboard');
+
+// ─────────────────────────────────────────────────────────────────────────
+// Export default
+// ─────────────────────────────────────────────────────────────────────────
+
+export default logger;