@true-tech-team/react-components 0.0.2 → 0.0.4

package/lib/contexts/PageMessagesContext/PageMessagesContext.d.ts

@@ -0,0 +1,91 @@
+import { ReactNode } from 'react';
+import { PageMessageStateConfig, LoadingStateConfig, PageMessagesProps } from '../../components/display/PageMessages/types';
+/**
+ * Default configurations for all page message states
+ */
+export interface PageMessagesDefaults {
+    /** Default loading configuration */
+    loading?: LoadingStateConfig;
+    /** Default error configuration */
+    error?: PageMessageStateConfig;
+    /** Default forbidden configuration */
+    forbidden?: PageMessageStateConfig;
+    /** Default not-found configuration */
+    notFound?: PageMessageStateConfig;
+    /** Default unauthorized configuration */
+    unauthorized?: PageMessageStateConfig;
+    /** Default maintenance configuration */
+    maintenance?: PageMessageStateConfig;
+    /** Default offline configuration */
+    offline?: PageMessageStateConfig;
+    /** Default timeout configuration */
+    timeout?: PageMessageStateConfig;
+    /** Default empty configuration */
+    empty?: PageMessageStateConfig;
+}
+/**
+ * Global actions that can be provided app-wide
+ */
+export interface PageMessagesGlobalActions {
+    /** Default retry handler */
+    onRetry?: () => void;
+    /** Default go back handler */
+    onGoBack?: () => void;
+    /** Default go home handler */
+    onGoHome?: () => void;
+    /** Default login handler */
+    onLogin?: () => void;
+}
+/**
+ * Context value for PageMessages
+ */
+export interface PageMessagesContextValue {
+    /** Default state configurations */
+    defaults: PageMessagesDefaults;
+    /** Global action handlers */
+    actions: PageMessagesGlobalActions;
+    /** Default component props */
+    defaultProps?: Partial<Pick<PageMessagesProps, 'size' | 'fullScreen' | 'centerVertically' | 'minHeight'>>;
+}
+export interface PageMessagesProviderProps {
+    children: ReactNode;
+    /** Default configurations for page message states */
+    defaults?: PageMessagesDefaults;
+    /** Global action handlers */
+    actions?: PageMessagesGlobalActions;
+    /** Default component props */
+    defaultProps?: PageMessagesContextValue['defaultProps'];
+}
+/**
+ * Provider for PageMessages defaults and global configuration
+ *
+ * @example
+ * ```tsx
+ * <PageMessagesProvider
+ *   defaults={{
+ *     error: {
+ *       title: 'Oops! Something went wrong',
+ *       description: 'Please try again later',
+ *       icon: 'error',
+ *     },
+ *   }}
+ *   actions={{
+ *     onGoHome: () => router.push('/'),
+ *     onLogin: () => router.push('/login'),
+ *   }}
+ * >
+ *   <App />
+ * </PageMessagesProvider>
+ * ```
+ */
+export declare function PageMessagesProvider({ children, defaults, actions, defaultProps, }: PageMessagesProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access PageMessages context
+ * Returns undefined if not within provider (uses built-in defaults)
+ */
+export declare function usePageMessages(): PageMessagesContextValue | undefined;
+/**
+ * Hook to get merged configuration (context defaults + component props)
+ * For internal use by PageMessages component
+ */
+export declare function usePageMessagesConfig(componentProps: Partial<PageMessagesProps>): PageMessagesContextValue;

package/lib/contexts/PageMessagesContext/index.d.ts

@@ -0,0 +1,2 @@
+export { PageMessagesProvider, usePageMessages, usePageMessagesConfig, } from './PageMessagesContext';
+export type { PageMessagesProviderProps, PageMessagesContextValue, PageMessagesDefaults, PageMessagesGlobalActions, } from './PageMessagesContext';

package/lib/contexts/index.d.ts

@@ -1,2 +1,4 @@
 export { ThemeProvider, useTheme } from './ThemeContext';
 export type { ThemeProviderProps } from './ThemeContext';
+export { PageMessagesProvider, usePageMessages } from './PageMessagesContext';
+export type { PageMessagesProviderProps, PageMessagesContextValue, PageMessagesDefaults, PageMessagesGlobalActions, } from './PageMessagesContext';

package/lib/providers/GlobalProvider/GlobalProvider.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { PageMessagesProviderProps } from '../../contexts/PageMessagesContext';
 import { ThemeConfig } from '../../types';
 export interface GlobalProviderProps {
     /**
@@ -13,6 +14,10 @@ export interface GlobalProviderProps {
      * Whether to inject global styles (default: true)
      */
     injectGlobalStyles?: boolean;
+    /**
+     * PageMessages default configuration
+     */
+    pageMessagesConfig?: Omit<PageMessagesProviderProps, 'children'>;
 }
 /**
  * GlobalProvider component that wraps the entire application
@@ -52,5 +57,5 @@ export interface GlobalProviderProps {
  * </GlobalProvider>
  * ```
  */
-export declare function GlobalProvider({ children, themeConfig, injectGlobalStyles, }: GlobalProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function GlobalProvider({ children, themeConfig, injectGlobalStyles, pageMessagesConfig, }: GlobalProviderProps): import("react/jsx-runtime").JSX.Element;
 export default GlobalProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@true-tech-team/react-components",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "React TypeScript component library",
   "main": "./index.js",
   "types": "./index.d.ts",

package/lib/assets/icons/index.d.ts

@@ -1,133 +0,0 @@
-import { default as Calendar } from './calendar.svg?react';
-import { default as ChevronDown } from './chevron-down.svg?react';
-import { default as ChevronUp } from './chevron-up.svg?react';
-import { default as ChevronLeft } from './chevron-left.svg?react';
-import { default as ChevronRight } from './chevron-right.svg?react';
-import { default as Close } from './close.svg?react';
-import { default as Check } from './check.svg?react';
-import { default as Minus } from './minus.svg?react';
-import { default as Plus } from './plus.svg?react';
-import { default as Info } from './info.svg?react';
-import { default as Help } from './help.svg?react';
-import { default as Warning } from './warning.svg?react';
-import { default as Error } from './error.svg?react';
-import { default as Eye } from './eye.svg?react';
-import { default as EyeOff } from './eye-off.svg?react';
-import { default as Edit } from './edit.svg?react';
-import { default as Copy } from './copy.svg?react';
-import { default as Delete } from './delete.svg?react';
-import { default as Settings } from './settings.svg?react';
-import { default as Profile } from './profile.svg?react';
-import { default as Preferences } from './preferences.svg?react';
-import { default as Account } from './account.svg?react';
-import { default as Logout } from './logout.svg?react';
-import { default as User } from './user.svg?react';
-import { default as Users } from './users.svg?react';
-import { default as Building } from './building.svg?react';
-import { default as Dollar } from './dollar.svg?react';
-import { default as ChartLine } from './chart-line.svg?react';
-import { default as ChartBar } from './chart-bar.svg?react';
-import { default as TrendingDown } from './trending-down.svg?react';
-/**
- * Icon registry mapping icon names to SVG components
- */
-export declare const iconRegistry: {
-    readonly calendar: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'chevron-down': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'chevron-up': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'chevron-left': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'chevron-right': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly close: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly check: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly minus: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly plus: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly info: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly help: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly warning: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly error: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly eye: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'eye-off': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly edit: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly copy: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly delete: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly settings: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly profile: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly preferences: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly account: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly logout: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly user: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly users: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly building: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly dollar: import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'chart-line': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'chart-bar': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-    readonly 'trending-down': import('react').FunctionComponent<import('react').SVGProps<SVGSVGElement> & {
-        title?: string;
-    }>;
-};
-/**
- * Available icon names
- */
-export type IconName = keyof typeof iconRegistry;
-/**
- * Named exports for direct import
- */
-export { Calendar, ChevronDown, ChevronUp, ChevronLeft, ChevronRight, Close, Check, Minus, Plus, Info, Help, Warning, Error, Eye, EyeOff, Edit, Copy, Delete, Settings, Profile, Preferences, Account, Logout, User, Users, Building, Dollar, ChartLine, ChartBar, TrendingDown, };