@spteck/react-controls-v2 2.6.0 → 2.6.2

package/dist/components/index.d.ts

@@ -1,4 +1,6 @@
 export * from './AspectRatio';
+export * from './BackgroundImage';
+export * from './BackgroundVideo';
 export * from './Card';
 export * from './Carousel';
 export * from './Center';
@@ -14,7 +16,6 @@ export * from './Provider';
 export * from './RenderLabel';
 export * from './RenderSpninner';
 export * from './Space';
-export * from './Stack';
 export * from './adaptiveCardHost';
 export * from './aiAssistant';
 export * from './breadcrumb';
@@ -54,4 +55,5 @@ export * from './KPIControl';
 export * from './SplitPane';
 export * from './MermaidDiagram';
 export * from './fluentUIProvider';
+export * from './Hero';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/stackv2/IStackV2Props.d.ts

@@ -61,7 +61,7 @@ export interface IStackV2Props {
     /**
      * Child components to be rendered inside the stack.
      */
-    children: React.ReactNode;
+    children?: React.ReactNode;
     /**
      * Additional inline styles.
      */
@@ -73,5 +73,13 @@ export interface IStackV2Props {
     overflow?: React.CSSProperties["overflow"];
     /** background Color */
     background?: React.CSSProperties["backgroundColor"];
+    /** HTML id attribute */
+    id?: string;
+    /** ARIA role */
+    role?: React.AriaRole;
+    /** ARIA label */
+    'aria-label'?: string;
+    /** ARIA hidden */
+    'aria-hidden'?: boolean | 'true' | 'false';
 }
 //# sourceMappingURL=IStackV2Props.d.ts.map

package/dist/components/videoPlayer/VideoPlayer.d.ts

@@ -40,9 +40,9 @@ export interface IVideoPlayerProps {
             tracks?: {
                 kind: string;
                 src: string;
-                srcLang?: string;
+                srcLang: string;
                 default?: boolean;
-                label?: string;
+                label: string;
             }[];
             forceVideo?: boolean;
             forceAudio?: boolean;

package/dist/hooks/index.d.ts

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

package/dist/hooks/useAIAssistant.d.ts

@@ -1,26 +1,5 @@
-export interface AIAssistantConfig {
-    endpoint?: string;
-    mcpServers?: Record<string, any>;
-    conversationId?: string;
-    requestHeaders?: Record<string, string>;
-}
-export interface AIAssistantMessage {
-    instructions?: string;
-    input: string;
-    timezone?: string;
-    locale?: string;
-    history?: string[];
-    mcpServers?: Record<string, any>;
-}
-export interface UseAIAssistantResult {
-    response: string;
-    isLoading: boolean;
-    error: string | null;
-    sendMessage: (message: AIAssistantMessage, onProgress?: (text: string) => void) => Promise<string>;
-    cancelRequest: () => void;
-    resetConversation: () => void;
-    conversationId: string;
-}
+import { AIAssistantConfig, IUseAIAssistantReturn } from '../models/IUseAIAssistant';
+export type { AIAssistantConfig, AIAssistantMessage, IUseAIAssistantReturn, UseAIAssistantResult } from '../models/IUseAIAssistant';
 /**
  * Custom hook for interacting with AI Assistant API with SSE streaming support
  *
@@ -47,5 +26,5 @@ export interface UseAIAssistantResult {
  * };
  * ```
  */
-export declare const useAIAssistant: (config: AIAssistantConfig) => UseAIAssistantResult;
+export declare const useAIAssistant: (config: AIAssistantConfig) => IUseAIAssistantReturn;
 //# sourceMappingURL=useAIAssistant.d.ts.map

package/dist/hooks/useAIAssistantParser.d.ts

@@ -1,31 +1,5 @@
-/**
- * Represents the parsed response from the AI Assistant SSE stream
- */
-export interface ParsedAIResponse<T = unknown> {
-    /** Parsed JSON data (typed as unknown for flexibility) */
-    data: T | undefined;
-    /** Raw text content extracted from SSE */
-    rawText: string;
-    /** Indicates if the response is valid JSON */
-    isJson: boolean;
-    /** Error message if parsing failed */
-    error?: string;
-}
-/**
- * Configuration options for the parser
- */
-export interface ParserOptions {
-    /** Whether to remove markdown code blocks (default: true) */
-    stripMarkdown?: boolean;
-    /** Whether to log debug information (default: false) */
-    debug?: boolean;
-}
-/**
- * Return type for the useAIAssistantParser hook
- */
-export interface UseAIAssistantParserReturn {
-    parseSSEResponse: <T = unknown>(rawResponse: string, options?: ParserOptions) => ParsedAIResponse<T>;
-}
+import { IUseAIAssistantParserReturn } from '../models/IUseAIAssistantParser';
+export type { ParsedAIResponse, ParserOptions, IUseAIAssistantParserReturn, UseAIAssistantParserReturn } from '../models/IUseAIAssistantParser';
 /**
  * Custom hook for parsing Server-Sent Events (SSE) responses from AI Assistant API
  *
@@ -41,5 +15,5 @@ export interface UseAIAssistantParserReturn {
  *
  * @returns Object containing parseSSEResponse function
  */
-export declare const useAIAssistantParser: () => UseAIAssistantParserReturn;
+export declare const useAIAssistantParser: () => IUseAIAssistantParserReturn;
 //# sourceMappingURL=useAIAssistantParser.d.ts.map

package/dist/hooks/useAppToast.d.ts

@@ -0,0 +1,27 @@
+import { IAppToasterConfig, IUseAppToastReturn } from '../models/IUseAppToast';
+export type { IAppToasterConfig, IUseAppToastReturn } from '../models/IUseAppToast';
+/**
+ * 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 toasterId = "app-toaster";
+export declare const useAppToast: (config?: IAppToasterConfig) => IUseAppToastReturn;
+//# sourceMappingURL=useAppToast.d.ts.map

package/dist/hooks/useBrandCenterFonts.d.ts

@@ -1,33 +1,5 @@
-import { IBrandCenterFont } from '../abstractions/IBrandCenterFonts';
-/** Options for the useBrandCenterFonts hook */
-export interface IUseBrandCenterFontsOptions {
-    /** SharePoint site URL (e.g. "https://contoso.sharepoint.com/sites/brand").
-     *  When omitted the hook reads it from `pageContext.web.absoluteUrl`. */
-    siteUrl?: string;
-    /** If true the hook will NOT fetch from Brand Center;
-     *  use `fonts` to supply a static list instead. */
-    disabled?: boolean;
-    /** Provide brand fonts directly instead of fetching from the API.
-     *  Useful for testing or when fonts are already available. */
-    fonts?: IBrandCenterFont[];
-}
-/** Return value of useBrandCenterFonts */
-export interface IUseBrandCenterFontsReturn {
-    /** Available Brand Center fonts (or Fluent UI defaults if Brand Center is not configured) */
-    fonts: IBrandCenterFont[];
-    /** Font family names ready for CSS / TypographyControl.fontFamily */
-    fontFamilyNames: string[];
-    /** The organization's default font (if any) */
-    defaultFont: IBrandCenterFont | undefined;
-    /** Whether data is currently being fetched */
-    loading: boolean;
-    /** Error message, if the fetch failed */
-    error: string | undefined;
-    /** Whether Brand Center fonts are configured for this tenant */
-    isBrandCenterAvailable: boolean;
-    /** Re-fetch fonts from the API */
-    refresh: () => Promise<void>;
-}
+import { IUseBrandCenterFontsOptions, IUseBrandCenterFontsReturn } from '../models/IUseBrandCenterFonts';
+export type { IUseBrandCenterFontsOptions, IUseBrandCenterFontsReturn } from '../models/IUseBrandCenterFonts';
 /**
  * React hook that loads fonts from the SharePoint Brand Center and
  * injects `@font-face` rules so they can be used anywhere in the app

package/dist/hooks/useExportData.d.ts

@@ -0,0 +1,25 @@
+import { IUseExportData } from '../models/IExportData';
+export type { IExcelHeaderStyle, ExportDataFetcher, IExportExcelOptions, IExportJSONOptions, IExportCSVOptions, IUseExportData, } from '../models/IExportData';
+/**
+ * Provides file download helpers for Excel (`.xlsx`), JSON, and CSV,
+ * with a built-in progress dialog that shows during async exports.
+ *
+ * Pass a static array for instant exports, or an {@link ExportDataFetcher}
+ * for paginated async sources — the dialog will track progress automatically.
+ *
+ * Mount `ProgressDialog` once in your component tree:
+ * ```tsx
+ * const { exportToExcel, exportToJSON, exportToCSV, ProgressDialog } = useExportData();
+ *
+ * return (
+ *   <>
+ *     <Button onClick={() => exportToExcel(fetcher, { fileName: 'report', includeMetaSheet: true })}>
+ *       Export to Excel
+ *     </Button>
+ *     {ProgressDialog}
+ *   </>
+ * );
+ * ```
+ */
+export declare const useExportData: () => IUseExportData;
+//# sourceMappingURL=useExportData.d.ts.map

package/dist/hooks/useFluentEmoji.d.ts

@@ -1,12 +1,8 @@
-export type TeamsReactionImageStyle = '3D' | 'Color' | 'Flat' | 'HighContrast';
-export interface IUseFluentEmojiResult {
-    getEmoji: (reactionType: string, style?: TeamsReactionImageStyle) => string | undefined;
-    getAvailableEmojis: () => string[];
-    hasEmoji: (reactionType: string, style?: TeamsReactionImageStyle) => boolean;
-}
+import { IUseFluentEmojiReturn } from '../models/IUseFluentEmoji';
+export type { TeamsReactionImageStyle, IUseFluentEmojiReturn, IUseFluentEmojiResult } from '../models/IUseFluentEmoji';
 /**
  * Resolves a Teams/Graph reactionType such as `yes`, `yes-tone2`, `heart`, or
  * a raw Unicode emoji glyph to a Fluent emoji image URL.
  */
-export declare const useFluentEmoji: () => IUseFluentEmojiResult;
+export declare const useFluentEmoji: () => IUseFluentEmojiReturn;
 //# sourceMappingURL=useFluentEmoji.d.ts.map

package/dist/hooks/useGraphAPI.d.ts

@@ -1,24 +1,8 @@
-import { User } from '@microsoft/microsoft-graph-types';
+import { IUseGraphAPIReturn } from '../models/IUseGraphAPI';
+export type { IUseGraphAPIReturn, IUserInfo } from '../models/IUseGraphAPI';
 /**
  * Hook for Microsoft Graph API operations
  * Uses the graph client from the application context
  */
-export declare const useGraphAPI: () => {
-    getUser: (userId: string) => Promise<User | null>;
-    getCurrentUser: () => Promise<User | null>;
-    searchUsers: (query: string, top?: number) => Promise<User[]>;
-    getUserPhoto: (userId: string) => Promise<string | null>;
-    graphClient: import('..').IGraphProvider | undefined;
-};
-/**
- * User information interface for convenience
- */
-export interface IUserInfo {
-    displayName?: string;
-    email?: string;
-    jobTitle?: string;
-    officeLocation?: string;
-    mobilePhone?: string;
-    businessPhones?: string[];
-}
+export declare const useGraphAPI: () => IUseGraphAPIReturn;
 //# sourceMappingURL=useGraphAPI.d.ts.map

package/dist/hooks/useHeroRotation.d.ts

@@ -0,0 +1,18 @@
+import { IHeroItem, IHeroRotation } from '../components/Hero/IHeroProps';
+export type { IUseHeroRotationOptions } from '../models/IUseHeroRotation';
+/**
+ * Manages the visible item slice for rotating Hero layouts.
+ *
+ * @param items    Full item pool provided by the consumer
+ * @param slots    Number of items the layout shows at once
+ *                 (1 for fullscreen, 2 for split / featured)
+ * @param rotation Optional rotation config from `IHeroProps.rotation`
+ * @returns        The slice of items to render right now
+ *
+ * Rotation only activates when `items.length > slots`.
+ * - `'interval'` mode: uses `usePolling` to advance the window by one position
+ *   every `intervalMs` ms (default 5 000 ms).
+ * - `'refresh'`  mode: picks a random starting index on mount and never changes it.
+ */
+export declare function useHeroRotation(items: IHeroItem[], slots: number, rotation?: IHeroRotation): IHeroItem[];
+//# sourceMappingURL=useHeroRotation.d.ts.map

package/dist/hooks/useIndexedDB.d.ts

@@ -1,19 +1,12 @@
+import { IUseIndexedDBCacheReturn, IUseCachedDataReturn } from '../models/IUseIndexedDB';
+export type { IUseIndexedDBCacheReturn, IUseCachedDataReturn } from '../models/IUseIndexedDB';
 /**
  * Hook for IndexedDB or generic storage operations
  * Uses the storage provider from the application context
  */
-export declare const useIndexedDBCache: <T = any>() => {
-    getCachedData: (key: string) => Promise<T | undefined>;
-    setCachedData: (key: string, value: T, expirationInMinutes?: number) => Promise<void>;
-    removeCachedData: (key: string) => Promise<void>;
-    clearCache: () => Promise<void>;
-};
+export declare const useIndexedDBCache: <T = any>() => IUseIndexedDBCacheReturn<T>;
 /**
  * Hook for caching data with automatic retrieval and storage
  */
-export declare const useCachedData: <T = any>(key: string, fetcher: () => Promise<T>, expirationInMinutes?: number) => {
-    data: T | undefined;
-    loading: boolean;
-    error: Error | undefined;
-};
+export declare const useCachedData: <T = any>(key: string, fetcher: () => Promise<T>, expirationInMinutes?: number) => IUseCachedDataReturn<T>;
 //# sourceMappingURL=useIndexedDB.d.ts.map

package/dist/hooks/useLocalizationStrings.d.ts

@@ -1,16 +1,6 @@
 import { ILibraryStrings } from '../localization/ILibraryStrings';
-export interface ILocalizationContext {
-    /** The underlying localization provider */
-    provider: unknown;
-    /** All resolved strings for the current locale */
-    strings: ILibraryStrings;
-    /** Current locale code */
-    locale: string;
-    /** Whether the current locale is RTL */
-    isRtl: boolean;
-    /** Change the active locale (triggers async bundle loading) */
-    setLocale: (locale: string) => Promise<void>;
-}
+import { ILocalizationContext } from '../models/IUseLocalizationStrings';
+export type { ILocalizationContext } from '../models/IUseLocalizationStrings';
 export declare const LocalizationContext: import('react').Context<ILocalizationContext | undefined>;
 /**
  * Hook to access the full localization context

package/dist/hooks/useLogging.d.ts

@@ -1,17 +1,10 @@
-import { LogLevel, ErrorType } from '../abstractions';
+import { IUseLoggingReturn } from '../models/IUseLogging';
+export type { IUseLoggingReturn } from '../models/IUseLogging';
 /**
  * Hook for logging operations
  * Uses the logging provider from the application context
  *
  * @returns Logging functions
  */
-export declare const useLogging: () => {
-    log: (message: string, level?: LogLevel, data?: any) => void;
-    error: (message: string, err?: Error, errorType?: ErrorType) => void;
-    warn: (message: string, data?: any) => void;
-    info: (message: string, data?: any) => void;
-    verbose: (message: string, data?: any) => void;
-    LogLevel: typeof LogLevel;
-    ErrorType: typeof ErrorType;
-};
+export declare const useLogging: () => IUseLoggingReturn;
 //# sourceMappingURL=useLogging.d.ts.map

package/dist/hooks/usePolling.d.ts

@@ -1,3 +1,5 @@
+import { IUsePollingReturn } from '../models/IUsePolling';
+export type { IUsePollingReturn } from '../models/IUsePolling';
 /**
  * Hook for polling data at regular intervals
  *
@@ -5,9 +7,5 @@
  * @param interval - Polling interval in milliseconds
  * @param immediate - Whether to call immediately on mount
  */
-export declare const usePolling: (callback: () => void | Promise<void>, interval: number, immediate?: boolean) => {
-    startPolling: () => void;
-    stopPolling: () => void;
-    isPolling: boolean;
-};
+export declare const usePolling: (callback: () => void | Promise<void>, interval: number, immediate?: boolean) => IUsePollingReturn;
 //# sourceMappingURL=usePolling.d.ts.map

package/dist/hooks/useTimeZoneHelper.d.ts

@@ -1,15 +1,15 @@
+import { IUseTimeZoneHelperReturn } from '../models/IUseTimeZoneHelper';
+export type { IUseTimeZoneHelperReturn } from '../models/IUseTimeZoneHelper';
 /**
- * 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) => {
-    getFormatRelative: (date: Date | string) => string;
-    convertDateToUTC: (date: Date | string) => Date;
-    formatDate: (date: Date | string, formatString?: string) => string;
-    getTimezoneOffset: () => number;
-    convertToTimezone: (date: Date | string, tz?: string) => string;
-};
+export declare const useTimeZoneHelper: (timezone?: string, locale?: string) => IUseTimeZoneHelperReturn;
 //# sourceMappingURL=useTimeZoneHelper.d.ts.map