@codebit-programando-solucoes/codebit-web-antd 1.1.9 → 1.1.20

package/dist/components/CssTokenBridge.d.ts

@@ -40,10 +40,18 @@ import { FC } from 'react';
  *
  * **Font size tokens:**
  *
+ * - --antd-font-size-xxs: 8px (Micro text, accessibility disclaimers, disabled elements)
+ * - --antd-font-size-xs: 10px (Extra small text, fine print, legal disclaimers)
  * - --antd-font-size-sm: 12px (Small text, captions, labels)
  * - --antd-font-size: 14px (Base font size, body text)
  * - --antd-font-size-lg: 16px (Large text, emphasis)
  * - --antd-font-size-xl: 20px (Extra large text, subheadings)
+ * - --antd-font-size-xxl: 24px (Largest base text size for prominent content)
+ * - --antd-font-size-heading1: 38px (Primary heading - main page titles)
+ * - --antd-font-size-heading2: 30px (Secondary heading - section titles)
+ * - --antd-font-size-heading3: 24px (Tertiary heading - subsections)
+ * - --antd-font-size-heading4: 20px (Quaternary heading - component titles)
+ * - --antd-font-size-heading5: 16px (Quinary heading - labels and captions)
  *
  * **Line height tokens:**
  *
@@ -64,6 +72,7 @@ import { FC } from 'react';
  *
  * @example
  *     ```tsx
+ *
  *     // Place this component at the root level of your app
  *     function App() {
  *       return (
@@ -77,6 +86,7 @@ import { FC } from 'react';
  *
  * @example
  *     ```css
+ *
  *     // Use the exposed CSS variables in your stylesheets
  *     .my-component {
  *       background-color: var(--antd-color-bg-container);

package/dist/components/LoggedMainContainer.d.ts

@@ -12,16 +12,17 @@ export interface LoggedMainContainerProps {
  * Provides a responsive layout with:
  *
  * - Collapsible sidebar navigation (desktop) or drawer menu (mobile)
+ * - Optional secondary sidebar/drawer for additional content
  * - Dynamic theme switching (light/dark mode)
  * - Role-based menu filtering
  * - User logout functionality
  * - Application version display
  *
- * This component must be used within a CodebitConfigProvider context to access configuration such as menu items, user data, and theme settings.
+ * This component must be used within a `CodebitConfigProvider` and `CodebitThemeContext` context to access configuration such as menu items, user data, and theme settings.
  *
  * @param props - Component props
  * @returns JSX.Element - Logged container layout
- * @throws Error if used CodebitConfigProvider context
+ * @throws Error if used outside `CodebitConfigProvider` and `CodebitThemeContext` contexts
  */
 export function LoggedMainContainer(
     props: LoggedMainContainerProps,

package/dist/components/ThemeToggle.d.ts

@@ -1,11 +1,10 @@
-import * as React from 'react';
+import { JSX } from 'react';
 
 /**
  * Theme switcher component that toggles between light and dark modes.
  *
- * This component displays a switch with sun/moon icons and handles theme toggling based on the context. It can be used independently or integrated with a theme context.
- *
  * @returns JSX.Element - A Switch component with theme toggle functionality.
- * @throws Error if used outside CodebitConfigProvider context
+ * @throws Error If used outside `CodebitThemeContext` context
+ * @component
  */
-export const ThemeToggle: () => React.JSX.Element;
+export const ThemeToggle: () => JSX.Element;

package/dist/contexts/CodebitConfigContext.d.ts

@@ -13,78 +13,74 @@ export interface MenuItem {
 }
 
 /** User object type */
-export interface UserType {
+export interface LoggedUser {
     /** User's full name */
-    name: string;
+    name?: string;
     /** User's email address */
-    email: string;
+    email?: string;
     /** Unique user identifier */
-    id: string;
+    id?: string;
     /** User roles/permissions */
-    roles: string[];
-}
-
-/** Context type for Codebit configuration */
-export interface CodebitConfigContextType {
-    /** Array of menu items */
-    menuItems: MenuItem[];
-    /** Current user object */
-    user: UserType;
-    /** Logout handler */
-    onLogout: () => void | Promise<void>;
-    /** Function to toggle the theme */
-    toggleTheme: () => void;
-    /** Current dark mode state */
-    isDarkMode: boolean;
-    /** Application version */
-    version?: string;
-    /** Show version in menu */
-    showVersion?: boolean;
-    /** OAuth callback URL for authentication */
-    oauthCallbackUrl: string;
-    /** Optional secondary sidebar content */
-    secondarySidebar?: React.ReactNode;
-    /** Width of the secondary sidebar */
-    secondarySidebarWidth?: number;
+    roles?: string[];
 }
 
-/** Context for Codebit configuration */
+/** The configuration context for Codebit application, providing access to session and UI settings. */
 export const CodebitConfigContext: React.Context<CodebitConfigContextType | null>;
 
-/** Props for the CodebitConfigProvider component */
-export interface CodebitConfigProviderProps {
-    /** Child components */
-    children: React.ReactNode;
-    /** Menu items configuration */
-    menuItems: MenuItem[];
-    /** Current user object */
-    user: UserType;
-    /** Logout handler */
-    onLogout: () => void | Promise<void>;
-    /** Function to toggle the theme */
-    toggleTheme: () => void;
-    /** Current dark mode state */
-    isDarkMode: boolean;
-    /** OAuth callback URL for authentication */
-    oauthCallbackUrl: string;
-    /** Application version. Default is '1.0' */
-    version?: string;
-    /** Show version in menu. Default is true */
-    showVersion?: boolean;
-    /** Optional secondary sidebar content */
-    secondarySidebar?: React.ReactNode;
-    /** Width of the secondary sidebar */
+/** Context type definition for Codebit configuration. */
+export interface CodebitConfigContextType {
+    /**
+     * A function that returns menu items configuration for the sidebar based on the current user's context. Takes an optional `LoggedUser` object as parameter and returns an array
+     * of `MenuItem` objects.
+     */
+    menuItems: (user?: LoggedUser) => MenuItem[];
+    /** Indicates if the user is currently logged in. */
+    isLogged: boolean;
+    /** The current user object, null when not logged in. */
+    user: LoggedUser | null;
+    /** Logs out the current user and resets session state. */
+    logout: () => Promise<void>;
+    /** Application version string. */
+    version: string;
+    /**
+     * A function that determines whether to display the application version in the UI based on user context. Takes an optional `LoggedUser` object as parameter and returns a
+     * boolean value.
+     */
+    showVersion: (user?: LoggedUser) => boolean;
+    /** A function that returns optional secondary sidebar content based on the current user's context. Takes an optional `LoggedUser` object as parameter and returns React nodes. */
+    secondarySidebar?: (user?: LoggedUser) => React.ReactNode | null;
+    /** Width of the secondary sidebar in pixels (default: 280). */
     secondarySidebarWidth?: number;
 }
 
 /**
- * Configuration provider for Codebit components. Similar to Ant Design's ConfigProvider.
- *
- * Provides global configuration for theme, user data, menu items, and authentication settings to all child components within the provider tree.
+ * Provider component for Codebit configuration and session management.
  *
- * @param props - Component props
- * @returns JSX.Element - Provider wrapper
+ * @param props - Configuration provider properties.
  */
 export function CodebitConfigProvider(
     props: CodebitConfigProviderProps,
-): React.JSX.Element;
+): React.ReactElement;
+
+/** Properties for the CodebitConfigProvider component. */
+export interface CodebitConfigProviderProps {
+    /** Child components that will have access to the configuration context. */
+    children: React.ReactNode;
+    /**
+     * A function that returns menu items configuration for the sidebar based on the current user's context. Takes an optional `LoggedUser` object as parameter and returns an array
+     * of `MenuItem` objects.
+     */
+    menuItems: (user?: LoggedUser) => MenuItem[];
+    /** Application version string (default: '1.0'). */
+    version?: string;
+    /** A function that determines whether to display the application version based on user context. Takes an optional `LoggedUser` object as parameter and returns a boolean value. */
+    showVersion?: (user?: LoggedUser) => boolean;
+    /** A function that returns optional secondary sidebar content based on user context. Takes an optional `LoggedUser` object as parameter and returns React nodes. */
+    secondarySidebar?: (user: LoggedUser) => React.ReactNode | null;
+    /** Width of the secondary sidebar in pixels (default: 280). */
+    secondarySidebarWidth?: number;
+    /** Function to handle user logout. */
+    doLogout: () => Promise<void>;
+    /** Function to check login status and return user data. */
+    checkLogin: () => Promise<any | null>;
+}

package/dist/contexts/CodebitThemeContext.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { ConfigProviderProps } from 'antd';
+
+/** Context for managing theme state in Codebit applications. Provides theme toggling and current theme state to components. */
+export const CodebitThemeContext: React.Context<CodebitThemeContextProps | null>;
+
+/** Provider component that wraps the application to enable theme management. */
+export const CodebitThemeProvider: React.FC<CodebitThemeProviderProps>;
+
+/** Context value type containing theme state and controls */
+interface CodebitThemeContextProps {
+    /** Current theme state (`true` for dark mode) */
+    isDarkMode: boolean;
+    /** Toggles between dark and light themes */
+    toggleTheme: () => void;
+    /** Manually sets the theme state */
+    setIsDarkMode: (isDark: boolean) => void;
+}
+
+/** Properties for the theme provider component */
+type CodebitThemeProviderProps = {
+    /** Child components that will have access to theme context */
+    children: React.ReactNode;
+    /** Whether to persist theme preference in localStorage (default: `true`) */
+    storeThemeInLocalStorage?: boolean;
+} & ConfigProviderProps;

package/dist/contexts/index.d.ts

@@ -1 +1,2 @@
 export * from './CodebitConfigContext';
+export * from './CodebitThemeContext';