@spteck/react-controls-v2 2.6.0 → 2.6.1

package/dist/hooks/index.d.ts

@@ -2,10 +2,11 @@ export * from './useLogging';
 export * from './useGraphAPI';
 export * from './useIndexedDB';
 export * from './usePolling';
-export * from './useTimeZone';
+export * from './useTimeZoneHelper';
 export * from './useAIAssistantParser';
 export * from './useAIAssistant';
 export * from './useLocalizationStrings';
 export * from './useBrandCenterFonts';
 export * from './useFluentEmoji';
+export * from './useAppToast';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/useAppToast.d.ts

@@ -0,0 +1,47 @@
+import { IToastContent } from '../models/IToastContent';
+import { IToastOptions } from '../models/IToastOptions';
+import * as React from "react";
+export declare const toasterId = "app-toaster";
+export interface IAppToasterConfig {
+    toasterId?: string;
+    position?: "top-start" | "top" | "top-end" | "bottom-start" | "bottom" | "bottom-end";
+    dir?: "ltr" | "rtl";
+    pauseOnHover?: boolean;
+    pauseOnWindowBlur?: boolean;
+}
+/**
+ * Consolidated toast hook that provides both toast functionality and the ToasterProvider component.
+ * This follows React best practices by consolidating all toast-related logic in one place.
+ *
+ * @param config - Optional configuration for toast positioning and behavior
+ * @returns Object containing toast methods and the ToasterProvider component
+ *
+ * @example
+ * ```tsx
+ * const { showSuccessToast, showErrorToast, ToasterProvider } = useAppToast({
+ *   position: "top-end"
+ * });
+ *
+ * // In your component JSX:
+ * return (
+ *   <div>
+ *     <YourContent />
+ *     <ToasterProvider />
+ *   </div>
+ * );
+ * ```
+ */
+export declare const useAppToast: (config?: IAppToasterConfig) => {
+    showToast: (content: IToastContent, options?: IToastOptions) => string;
+    showSuccessToast: (title: string | React.ReactNode, body?: string | React.ReactNode, options?: Omit<IToastOptions, "intent">) => string;
+    showErrorToast: (title: string | React.ReactNode, body?: string | React.ReactNode, options?: Omit<IToastOptions, "intent">) => string;
+    showWarningToast: (title: string | React.ReactNode, body?: string | React.ReactNode, options?: Omit<IToastOptions, "intent">) => string;
+    showInfoToast: (title: string | React.ReactNode, body?: string | React.ReactNode, options?: Omit<IToastOptions, "intent">) => string;
+    dismissToast: (toastId: string) => void;
+    dismissAllToasts: () => void;
+    updateToast: (toastId: string, content: Partial<IToastContent>, options?: Partial<IToastOptions>) => void;
+    playToast: (toastId: string) => void;
+    pauseToast: (toastId: string) => void;
+    ToasterProvider: React.ComponentType;
+};
+//# sourceMappingURL=useAppToast.d.ts.map

package/dist/hooks/useTimeZoneHelper.d.ts

@@ -1,11 +1,20 @@
 /**
- * Hook for time zone and date/time formatting operations
+ * Unified hook for timezone conversions and locale-aware date/time formatting.
  *
- * @param timezone - Optional timezone string (e.g., 'America/New_York')
- * @param locale - Optional locale string (e.g., 'en-US')
- * @returns Object with date formatting functions
+ * Combines DST-safe conversions (date-fns-tz) with locale-aware relative/absolute
+ * formatting (date-fns). Optionally reads the user timezone from the application
+ * context when running inside a UniversalProvider.
+ *
+ * @param timezone - Optional timezone string (e.g. 'America/New_York').
+ *                   Falls back to the browser timezone when omitted.
+ * @param locale   - Optional locale code (e.g. 'en-US'). Defaults to 'en-US'.
  */
 export declare const useTimeZoneHelper: (timezone?: string, locale?: string) => {
+    timeZone: string;
+    convertToUserTimeZone: (date: Date, targetTimeZone?: string) => Date;
+    convertFromUserTimeZone: (date: Date, sourceTimeZone?: string) => Date;
+    formatInTimeZone: (date: Date, formatStr: string, targetTimeZone?: string) => string;
+    getUserTimeZone: () => string;
     getFormatRelative: (date: Date | string) => string;
     convertDateToUTC: (date: Date | string) => Date;
     formatDate: (date: Date | string, formatString?: string) => string;