@spteck/react-controls-v2 2.0.18 → 2.2.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 João Mendes
+Copyright (c) 2025-2026 João Mendes
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,431 +1,187 @@
-# @spteck/react-controls-v2 v2
+# @spteck/react-controls-v2
 
-> Framework-agnostic React UI controls library based on Fluent UI 9 - Works seamlessly with Vite, Next.js, and SPFx!
+A comprehensive, framework-agnostic React component library built on **Fluent UI 9**, designed for enterprise applications. Works seamlessly with **Vite**, **Next.js**, **Create React App**, and **SharePoint Framework (SPFx)**.
 
-## 🎯 What's New in V2?
+---
 
-**V2 is a complete rewrite** that eliminates all SPFx-specific dependencies, making these controls truly universal:
+## Features
 
-- ✅ **Zero SPFx dependencies** in the core library
-- ✅ **Works in any React app**: Vite, Next.js, Create React App, SPFx
-- ✅ **Abstraction layer** for flexibility and testability
-- ✅ **Tree-shakeable** - only import what you need
-- ✅ **Full TypeScript support** with comprehensive types
-- ✅ **Modern build system** using Vite
+- **Framework Agnostic** — Works with any React 17+ or 18+ project
+- **Fluent UI 9 Based** — Modern Microsoft design system with full theming support
+- **Full TypeScript Support** — Strongly typed props and interfaces
+- **SPFx Ready** — Supports SharePoint Framework without SPFx-specific dependencies in the core
+- **Microsoft Graph Integration** — Built-in hooks and providers for Microsoft Graph API
+- **Responsive Design** — Breakpoint-based spacing and layout utilities
+- **Tree-Shakeable** — Import only what you need
+- **Accessible** — WCAG-compliant via Fluent UI
+- **Adaptive Cards** — Full Adaptive Cards rendering with Fluent UI styling
+- **AI Components** — Chat assistant and AI-powered search out of the box
 
-## 📦 Installation
+---
 
-### For Vite/Next.js/Standard React Apps
+## Showcase & Documentation
 
-```bash
-npm install @spteck/react-controls-v2
-```
-
-### For SPFx Applications
-
-```bash
-npm install @spteck/react-controls-v2 @spteck/react-controls-v2-spfx-adapter
-```
-
-## ⚠️ Important: Components Requiring Microsoft Graph
-
-Some components (like `UserCard`, `LivePersona`, `AIAssistant`) require a Microsoft Graph client to fetch user data and presence information. 
-
-**📖 See the complete setup guide:** [GRAPH_CLIENT_SETUP.md](./GRAPH_CLIENT_SETUP.md)
-
-Quick overview:
-- **SPFx**: Automatically handled by the SPFx adapter ✅
-- **Vite/Next.js**: You must provide a graph client with authentication (MSAL recommended)
-- **Development**: Use a static token from [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer)
-
-## 🚀 Quick Start
-
-### 1. Vite/React Application
-
-```typescript
-import React from 'react';
-import { 
-  UniversalProvider, 
-  UserCard,
-  DefaultGraphClient,
-  ConsoleLoggingProvider,
-  LocalStorageProvider
-} from '@spteck/react-controls-v2';
-
-function App() {
-  const context = {
-    graphClient: new DefaultGraphClient({ 
-      accessToken: 'YOUR_ACCESS_TOKEN' 
-    }),
-    loggingProvider: new ConsoleLoggingProvider('MyApp'),
-    storageProvider: new LocalStorageProvider(),
-    pageContext: {
-      user: {
-        displayName: 'John Doe',
-        email: 'john@contoso.com',
-        loginName: 'john@contoso.com'
-      }
-    }
-  };
-
-  return (
-    <UniversalProvider context={context}>
-      <div className="App">
-        <h1>My Application</h1>
-        <UserCard userId="user-id-123" />
-      </div>
-    </UniversalProvider>
-  );
-}
-
-export default App;
-```
-
-### 2. Next.js Application
-
-```typescript
-// app/layout.tsx or pages/_app.tsx
-import { 
-  UniversalProvider,
-  DefaultGraphClient,
-  IApplicationContext 
-} from '@spteck/react-controls-v2';
-
-export default function RootLayout({ children }: { children: React.ReactNode }) {
-  // You can fetch the access token from your auth provider (NextAuth, etc.)
-  const context: IApplicationContext = {
-    graphClient: new DefaultGraphClient({
-      getAccessToken: async (scopes) => {
-        // Your logic to get token
-        return await getAccessToken(scopes);
-      }
-    }),
-    pageContext: {
-      user: {
-        displayName: 'Current User',
-        email: 'user@contoso.com',
-        loginName: 'user@contoso.com'
-      }
-    }
-  };
-
-  return (
-    <html lang="en">
-      <body>
-        <UniversalProvider context={context}>
-          {children}
-        </UniversalProvider>
-      </body>
-    </html>
-  );
-}
-```
-
-### 3. SPFx Application
-
-```typescript
-import * as React from 'react';
-import * as ReactDom from 'react-dom';
-import { BaseClientSideWebPart } from '@microsoft/sp-webpart-base';
-import { UniversalProvider } from '@spteck/react-controls-v2';
-import { SPFxContextAdapter } from '@spteck/react-controls-v2-spfx-adapter';
-import { UserCard } from '@spteck/react-controls-v2';
-
-export default class MyWebPart extends BaseClientSideWebPart {
-  public render(): void {
-    // Convert SPFx context to Universal context
-    const universalContext = SPFxContextAdapter.adapt(
-      this.context,
-      'MyWebPart'
-    );
-    
-    const element = (
-      <UniversalProvider context={universalContext}>
-        <div>
-          <h2>Hello from SPFx!</h2>
-          <UserCard userId="user-123" />
-        </div>
-      </UniversalProvider>
-    );
-    
-    ReactDom.render(element, this.domElement);
-  }
-}
-```
+> **Live demos, code samples, and usage details for every component are available at:**
+>
+> **[https://reactcontrols.spteckapps.com](https://reactcontrols.spteckapps.com)**
 
-## 🏗️ Architecture
+Visit the showcase site to explore interactive previews, copy ready-to-use code snippets, and see all available props for each control.
 
-### Abstraction Layer
+---
 
-The library uses an abstraction layer that allows it to work across different platforms:
+## Installation
 
-```typescript
-interface IApplicationContext {
-  pageContext?: IPageContext;
-  graphClient?: IGraphProvider;
-  authProvider?: IAuthenticationProvider;
-  loggingProvider?: ILoggingProvider;
-  storageProvider?: IStorageProvider;
-}
+```bash
+npm install @spteck/react-controls-v2
 ```
 
-### Providers
-
-#### Default Providers (For Vite/Next.js)
-
-```typescript
-import {
-  DefaultGraphClient,
-  ConsoleLoggingProvider,
-  LocalStorageProvider
-} from '@spteck/react-controls-v2/providers';
+### Peer Dependencies
 
-const graphClient = new DefaultGraphClient({
-  accessToken: 'token',
-  // OR
-  getAccessToken: async (scopes) => await fetchToken(scopes)
-});
-
-const logger = new ConsoleLoggingProvider('MyApp');
-const storage = new LocalStorageProvider('myapp_');
+```bash
+npm install react react-dom
 ```
 
-#### SPFx Providers (via Adapter)
-
-```typescript
-import { SPFxContextAdapter } from '@spteck/react-controls-v2-spfx-adapter';
+For SPFx applications:
 
-const context = SPFxContextAdapter.adapt(this.context, 'ComponentName');
-// This automatically provides SPFx-native implementations of all providers
+```bash
+npm install @spteck/react-controls-v2 @spteck/react-controls-v2-spfx-adapter
 ```
 
-## 📚 Available Components
-
-### Layout Components
-- `Card` - Flexible card container
-- `Grid` - Responsive grid system
-- `Layout` - Page layout wrapper
-- `Space` - Spacing component
-- `Stack` - Vertical/horizontal stack
-- `AspectRatio` - Maintain aspect ratios
-- `Center` - Center content
-- `Container` - Content container
-- `Carousel` - Image/content carousel
-- `Popup` - Popup dialogs
-
-### UI Components
-- `TypographyControl` - Text styling
-- `ButtonMenu` - Button with dropdown menu
-- `RenderLabel` - Label rendering
-- `RenderSpinner` - Loading spinners
-
-### Data Components
-*(More components coming in future releases)*
-
-## 🎣 Available Hooks
-
-### useApplicationContext
-Access the application context anywhere in your component tree:
-
-```typescript
-import { useApplicationContext } from '@spteck/react-controls-v2';
-
-function MyComponent() {
-  const context = useApplicationContext();
-  const user = context?.pageContext?.user;
-  
-  return <div>Welcome, {user?.displayName}!</div>;
-}
-```
+---
+
+## Available Controls
+
+### Layout & Structure
+
+| Component | Description |
+|-----------|-------------|
+| `Stack` | Flexbox horizontal/vertical layout with alignment and gap |
+| `StackV2` | Extended stack with responsive spacing, alignment, and wrapping |
+| `Grid` | CSS Grid layout with responsive columns and auto-flow |
+| `Layout` | Named grid-area template layout (e.g., Holy Grail) |
+| `Card` | Fluent UI Card with header, body, footer and preview |
+| `Space` | Inline spacing / visual gap utility |
+| `AspectRatio` | Constrain content to a fixed aspect ratio |
+| `Center` | Center content horizontally and/or vertically |
+| `Container` | Responsive max-width container |
+| `Carousel` | Horizontally scrollable item carousel |
+| `Popup` | Floating popover / popup panel |
+
+### Forms & Input
+
+| Component | Description |
+|-----------|-------------|
+| `SelectDate` | Date picker with calendar dropdown |
+| `SelectTime` | Time picker with configurable intervals |
+| `SelectView` | View mode switcher (list, grid, compact) |
+| `InputField` | Text input with validation and labels |
+| `Dropdown` | Single/multi-select dropdown |
+| `SearchControl` | Search box with filtering |
+| `IconButton` | Icon-only button with tooltip |
+| `ItemPicker` | Tag-based item picker with suggestions |
+| `CalendarControl` | Full calendar with month, week and day views |
+
+### Data Display
 
-### useGraphAPI
-Make Microsoft Graph API calls:
-
-```typescript
-import { useGraphAPI } from '@spteck/react-controls-v2';
-
-function UserProfile() {
-  const { getUser, getCurrentUser } = useGraphAPI();
-  
-  useEffect(() => {
-    async function fetchUser() {
-      const user = await getCurrentUser();
-      console.log(user);
-    }
-    fetchUser();
-  }, []);
-  
-  return <div>...</div>;
-}
-```
+| Component | Description |
+|-----------|-------------|
+| `DataGrid` | Sortable, selectable, resizable data table |
+| `DataGridV2` | Virtualized high-performance data grid |
+| `KPICard` | Key performance indicator card (default and compact) |
 
-### useLogging
-Logging with different levels:
-
-```typescript
-import { useLogging, LogLevel, ErrorType } from '@spteck/react-controls-v2';
-
-function MyComponent() {
-  const { log, error, warn, info } = useLogging();
-  
-  useEffect(() => {
-    info('Component mounted');
-    log('Custom log message', LogLevel.Verbose);
-  }, []);
-  
-  const handleError = (err: Error) => {
-    error('An error occurred', err, ErrorType.Error);
-  };
-  
-  return <div>...</div>;
-}
-```
+### Navigation
 
-### useIndexedDBCache
-Caching with expiration:
-
-```typescript
-import { useIndexedDBCache } from '@spteck/react-controls-v2';
-
-function CachedDataComponent() {
-  const { getCachedData, setCachedData } = useIndexedDBCache();
-  
-  useEffect(() => {
-    async function loadData() {
-      const cached = await getCachedData('myKey');
-      if (!cached) {
-        const freshData = await fetchData();
-        await setCachedData('myKey', freshData, 60); // Cache for 60 minutes
-      }
-    }
-    loadData();
-  }, []);
-  
-  return <div>...</div>;
-}
-```
+| Component | Description |
+|-----------|-------------|
+| `Navigation` | Side navigation drawer with sections and icons |
+| `Breadcrumb` | Navigation breadcrumb with overflow support |
+| `ButtonMenu` | Button with a dropdown list of options |
+| `CustomControlBar` | Configurable toolbar for custom actions |
 
-### usePolling
-Poll data at regular intervals:
-
-```typescript
-import { usePolling } from '@spteck/react-controls-v2';
-
-function LiveDataComponent() {
-  const { startPolling, stopPolling, isPolling } = usePolling(
-    async () => {
-      const data = await fetchLiveData();
-      setData(data);
-    },
-    5000, // Poll every 5 seconds
-    true  // Start immediately
-  );
-  
-  return (
-    <div>
-      <button onClick={startPolling}>Start</button>
-      <button onClick={stopPolling}>Stop</button>
-      {isPolling && <span>Polling...</span>}
-    </div>
-  );
-}
-```
+### Dialogs & Overlays
 
-### useTimeZoneHelper
-Handle timezone conversions:
-
-```typescript
-import { useTimeZoneHelper } from '@spteck/react-controls-v2';
-
-function DateDisplay() {
-  const { formatInTimeZone, timeZone } = useTimeZoneHelper();
-  
-  const formattedDate = formatInTimeZone(
-    new Date(),
-    'yyyy-MM-dd HH:mm:ss',
-    'America/New_York'
-  );
-  
-  return <div>Current timezone: {timeZone}</div>;
-}
-```
+| Component | Description |
+|-----------|-------------|
+| `RenderDialog` | Fluent UI modal dialog with title and actions |
+| `RenderDrawer` | Side-panel drawer (start or end position) |
+| `RenderHeader` | Page or section header with actions |
 
-## 🔧 Utility Functions
+### Feedback & Status
 
-### Lodash Utilities
-```typescript
-import { debounce, throttle, cloneDeep } from '@spteck/react-controls-v2';
+| Component | Description |
+|-----------|-------------|
+| `ShowError` | Friendly error message display |
+| `ShowMessage` | Info / success / warning status banner |
+| `RenderSpinner` | Loading spinner |
 
-const debouncedSearch = debounce((query) => {
-  performSearch(query);
-}, 300);
-```
+### Typography
 
-## 🎨 Theming
+| Component | Description |
+|-----------|-------------|
+| `TypographyControl` | Fluent-styled text with variant, size and color support |
+| `RenderLabel` | Field label with optional required indicator |
+| `MarkdownRenderer` | Converts Markdown to styled HTML |
+| `ContentRenderer` | Auto-detects and renders Markdown, HTML or plain text |
 
-All components use Fluent UI 9 theming. You can wrap your app with Fluent UI providers:
+### Media & Content
 
-```typescript
-import { FluentProvider, webLightTheme } from '@fluentui/react-components';
-import { UniversalProvider } from '@spteck/react-controls-v2';
+| Component | Description |
+|-----------|-------------|
+| `VideoPlayer` | Multi-source video player (YouTube, Vimeo, MP4, etc.) |
+| `AdaptiveCardHost` | Renders Adaptive Cards with Fluent UI styling |
+| `WorldMap` | Interactive world map with MapLibre GL |
 
-function App() {
-  return (
-    <FluentProvider theme={webLightTheme}>
-      <UniversalProvider context={myContext}>
-        <YourApp />
-      </UniversalProvider>
-    </FluentProvider>
-  );
-}
-```
+### People & Users
 
-## 📖 Migration from V1
+| Component | Description |
+|-----------|-------------|
+| `UserCard` | User persona with live presence status from Graph API |
+| `LivePersona` | Persona wrapper with SPFx hover card support |
+| `StackedUsers` | Overlapping avatar stack for groups of users |
+| `ListItemActivityMessage` | SharePoint list item activity/audit trail |
 
-If you're migrating from V1 (the SPFx-dependent version):
+### AI & Advanced
 
-1. **For SPFx apps**: Install the adapter package and use `SPFxContextAdapter.adapt()`
-2. **For non-SPFx apps**: Replace context with `IApplicationContext`
-3. **Update imports**: Change from `@spteck/m365-hooks` to internal hooks
-4. **Provider setup**: Wrap your app with `UniversalProvider`
+| Component | Description |
+|-----------|-------------|
+| `AIAssistant` | Full streaming AI chat assistant |
+| `AISearchControl` | Natural language search powered by Azure OpenAI |
 
-Example migration:
+### Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useApplicationContext()` | Access application context anywhere inside `UniversalProvider` |
+| `useGraphAPI()` | Make Microsoft Graph API calls with built-in error handling |
+| `useLogging()` | Structured logging via the configured provider |
+| `useIndexedDBCache()` | IndexedDB-based caching with TTL support |
+| `usePolling(fn, interval)` | Repeatedly call a function at a fixed interval |
+| `useTimeZoneHelper()` | Format and convert dates across time zones |
+
+### Core & Utilities
+
+| Component | Description |
+|-----------|-------------|
+| `UniversalProvider` | Root context provider for the whole app |
+| `BaseComponentProps` | Shared responsive spacing/sizing interface |
+| `LocalStorageProvider` | `IStorageProvider` implementation using localStorage |
 
-```typescript
-// V1 (SPFx only)
-import { UserCard } from '@spteck/react-controls';
-<UserCard context={this.context} userId="123" />
+---
 
-// V2 (SPFx)
-import { UniversalProvider, UserCard } from '@spteck/react-controls-v2';
-import { SPFxContextAdapter } from '@spteck/react-controls-v2-spfx-adapter';
+## Disclaimer
 
-const universalContext = SPFxContextAdapter.adapt(this.context);
-<UniversalProvider context={universalContext}>
-  <UserCard userId="123" />
-</UniversalProvider>
+This project is provided **"as is"**, without warranty of any kind, express or implied. The author(s) make no representations or guarantees regarding the accuracy, reliability, completeness, or suitability of this software for any particular purpose.
 
-// V2 (Non-SPFx)
-import { UniversalProvider, UserCard } from '@spteck/react-controls-v2';
-<UniversalProvider context={myCustomContext}>
-  <UserCard userId="123" />
-</UniversalProvider>
-```
+By using this library you acknowledge and agree that:
 
-## 🤝 Contributing
+- **No liability** — The author(s) shall not be held responsible or liable for any damages, losses, costs, or expenses arising from the use or inability to use this software, including but not limited to bugs, data loss, security vulnerabilities, service interruptions, or any other issue.
+- **No warranty** — There is no guarantee that this software is free of defects, errors, or security vulnerabilities. It is your responsibility to evaluate and bear all risks associated with its use.
+- **No obligation** — The author(s) are under no obligation to provide support, maintenance, updates, bug fixes, or enhancements. Any support provided is entirely at the author's discretion.
+- **Use at your own risk** — This software is intended for educational and professional use. You are solely responsible for determining the appropriateness of using or redistributing it and assume all risks associated with your use.
+- **Not affiliated** — This project is a personal/community initiative and is **not affiliated with, endorsed by, or supported by Microsoft Corporation** or any other organization.
 
-Contributions are welcome! Please read our contributing guidelines before submitting PRs.
+The source code is **not publicly available**. This library is distributed as a compiled package under the MIT License. If you require access to the source code, please contact the author at [joao.j.mendes@spteck.com](mailto:joao.j.mendes@spteck.com).
 
-## 📄 License
+## License
 
 MIT © João Mendes
-
-## 🔗 Links
-
-- [NPM Package](https://www.npmjs.com/package/@spteck/react-controls-v2)
-- [GitHub Repository](https://github.com/joaojmendes/react-controls)
-- [Documentation](https://github.com/joaojmendes/react-controls/tree/main/v2)
-
-## ⭐ Show your support
-
-Give a ⭐️ if this project helped you!

package/dist/LocalizationProvider-BLjmybBa.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=Object.defineProperty,r=(r,t,s)=>((r,t,s)=>t in r?e(r,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):r[t]=s)(r,"symbol"!=typeof t?t+"":t,s);const t=require("react/jsx-runtime"),s=require("react");var o=(e=>(e[e.Verbose=0]="Verbose",e[e.Info=1]="Info",e[e.Warning=2]="Warning",e[e.Error=3]="Error",e))(o||{}),i=(e=>(e.Error="Error",e.Warning="Warning",e.Info="Info",e))(i||{});const n={common:{loading:"Loading...",error:"Error",noData:"No data",close:"Close",save:"Save",cancel:"Cancel",ok:"OK",searchPlaceholder:"Search..."},kpi:{noDescription:"No description available",defaultTitle:"KPI",lowerIsBetter:"Lower is better",higherIsBetter:"Higher is better",withinGoalThreshold:"Within goal threshold",exceedsGoalThreshold:"Exceeds goal threshold",goal:"Goal",progressGoal:"Progress to goal",maxAllowedThreshold:"Max allowed threshold",totalItemsInScope:"Total items in scope",totalItems:"Total",currentValueAsPercent:"Current value as percentage of total",percentOfTotal:"%",onTrack:"On Track",exceedGoal:"Exceeds Goal"},noKpis:{title:"No KPIs Configured",subtitle:"Start tracking your team's performance by configuring {highlight} in the App Configuration list.",highlightText:"KPI parameters",configureButton:"Configure KPIs"},calendar:{calendarControl:{daysOfWeek:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"]},selectCalendarView:{month:"Month",week:"Week",day:"Day"},eventPopoverCard:{timeSeparator:" - ",hourSuffix:"h"},eventDetailsPopover:{start:"Start",end:"End",location:"Location",attendees:"Attendees",details:"Details"},dayView:{allDay:"All Day"},toolbar:{today:"Today",previous:"Previous",next:"Next"},weekView:{allDay:"All Day"},calendarMonth:{months:["January","February","March","April","May","June","July","August","September","October","November","December"],shortMonths:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],days:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],shortDays:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],goToToday:"Go to today"},selectWeek:{selectWeekPlaceholder:"Select a Week"}},mensions:{placeholder:"Type a message...",noResults:"No results found",send:"Send"},shareDialog:{title:"Share",copyLink:"Copy link",linkCopied:"Link copied!",share:"Share",cancel:"Cancel"},userCard:{available:"Available",availableIdle:"Available, idle",away:"Away",busy:"Busy",busyIdle:"Busy, idle",doNotDisturb:"Do not disturb",beRightBack:"Be right back",appearOffline:"Appear offline",unknown:"Unknown",outOfOffice:"Out of office",offline:"Offline",userAvatar:"User Avatar",unknownUser:"Unknown User"},appDashboard:{noDashboardsAvailable:"No Dashboards Available",clickToSetSpan:"Click to set span",configure:"Configure"},aiAssistant:{processingError:"There was an error processing your request.",noUsersFound:"No users found",typeAMessage:"Type a message"},worldMap:{loadingMapStyle:"Loading map style…",coordinates:"Coordinates:",zoomIn:"Zoom in",zoomOut:"Zoom out",resetMap:"Reset map",reset:"Reset"},aiSearchControl:{placeholder:"Ask AI to generate search query... (e.g., 'Find engineers in the Seattle office')",notConfiguredError:"Azure OpenAI is not properly configured. Please check your configuration.",generationError:"An error occurred during AI search query generation"},itemPicker:{placeholder:"Search…",noResultsFound:"No results found",searching:"Searching…",loadingMore:"Loading more…",selectedItems:"Selected items",searchItems:"Search items"},listItemActivity:{you:"You",accessed:"accessed this",commented:"commented on this",created:"created this",deleted:"deleted this",edited:"edited this",mentioned:"mentioned you in this",moved:"moved this",renamed:"renamed this",restored:"restored this",shared:"shared this",versioned:"versioned this"},inputField:{fieldRequired:"This field is required",numberRequired:"A number is required",invalidNumber:"Please enter a valid number",valueMustBeAtLeast:"Value must be at least {0}",valueMustBeAtMost:"Value must be at most {0}"},searchControl:{placeholder:"Search…"},mermaidDiagram:{loading:"Loading diagram…",errorTitle:"Diagram Error",errorMessage:"An error occurred while rendering the diagram.",noSource:"No diagram source provided"}};function a(e,r){const t={...e};for(const s of Object.keys(r)){const o=r[s],i=e[s];null==o||"object"!=typeof o||Array.isArray(o)||"object"!=typeof i||Array.isArray(i)||null===i?void 0!==o&&(t[s]=o):t[s]=a(i,o)}return t}const l={ar:()=>Promise.resolve().then(()=>require("./ar-Jzw7PLrc.cjs")).then(e=>e.ar),az:()=>Promise.resolve().then(()=>require("./az-C0Ow5Hxa.cjs")).then(e=>e.az),bg:()=>Promise.resolve().then(()=>require("./bg-YB0TmpRF.cjs")).then(e=>e.bg),bs:()=>Promise.resolve().then(()=>require("./bs-BoW04lRb.cjs")).then(e=>e.bs),ca:()=>Promise.resolve().then(()=>require("./ca-Bsy2Y5pS.cjs")).then(e=>e.ca),cs:()=>Promise.resolve().then(()=>require("./cs-D-801PIR.cjs")).then(e=>e.cs),cy:()=>Promise.resolve().then(()=>require("./cy-aUPUcn-S.cjs")).then(e=>e.cy),da:()=>Promise.resolve().then(()=>require("./da-CTiLOqut.cjs")).then(e=>e.da),de:()=>Promise.resolve().then(()=>require("./de-Dm204UMA.cjs")).then(e=>e.de),el:()=>Promise.resolve().then(()=>require("./el-DbtZj-ph.cjs")).then(e=>e.el),es:()=>Promise.resolve().then(()=>require("./es-Cc-4Vqf7.cjs")).then(e=>e.es),et:()=>Promise.resolve().then(()=>require("./et-D5pQ66eY.cjs")).then(e=>e.et),eu:()=>Promise.resolve().then(()=>require("./eu-RZ-27koK.cjs")).then(e=>e.eu),fi:()=>Promise.resolve().then(()=>require("./fi-Dqa9mgnW.cjs")).then(e=>e.fi),fr:()=>Promise.resolve().then(()=>require("./fr-B7fhkle4.cjs")).then(e=>e.fr),ga:()=>Promise.resolve().then(()=>require("./ga-4Hf7vKvr.cjs")).then(e=>e.ga),gl:()=>Promise.resolve().then(()=>require("./gl-COSpsMSK.cjs")).then(e=>e.gl),he:()=>Promise.resolve().then(()=>require("./he-C7Wi6-EL.cjs")).then(e=>e.he),hi:()=>Promise.resolve().then(()=>require("./hi-ojklJj-a.cjs")).then(e=>e.hi),hr:()=>Promise.resolve().then(()=>require("./hr-DkEwOCGU.cjs")).then(e=>e.hr),hu:()=>Promise.resolve().then(()=>require("./hu-D8uAAzvN.cjs")).then(e=>e.hu),id:()=>Promise.resolve().then(()=>require("./id-18yPGK2f.cjs")).then(e=>e.id),it:()=>Promise.resolve().then(()=>require("./it-BVq911RW.cjs")).then(e=>e.it),ja:()=>Promise.resolve().then(()=>require("./ja-BgcKuKZ4.cjs")).then(e=>e.ja),kk:()=>Promise.resolve().then(()=>require("./kk-Dn3FBkOR.cjs")).then(e=>e.kk),ko:()=>Promise.resolve().then(()=>require("./ko-CKAbV25b.cjs")).then(e=>e.ko),lt:()=>Promise.resolve().then(()=>require("./lt-BnGNEsIS.cjs")).then(e=>e.lt),lv:()=>Promise.resolve().then(()=>require("./lv-D3rJQRhc.cjs")).then(e=>e.lv),mk:()=>Promise.resolve().then(()=>require("./mk-hVxJgrE0.cjs")).then(e=>e.mk),ms:()=>Promise.resolve().then(()=>require("./ms-D0txYckK.cjs")).then(e=>e.ms),nb:()=>Promise.resolve().then(()=>require("./nb-BfKRl99z.cjs")).then(e=>e.nb),nl:()=>Promise.resolve().then(()=>require("./nl-ZXiLkBj_.cjs")).then(e=>e.nl),pl:()=>Promise.resolve().then(()=>require("./pl-tVjdYTB9.cjs")).then(e=>e.pl),pt:()=>Promise.resolve().then(()=>require("./pt-1k62N9F3.cjs")).then(e=>e.pt),ro:()=>Promise.resolve().then(()=>require("./ro-9Qt1qDDA.cjs")).then(e=>e.ro),ru:()=>Promise.resolve().then(()=>require("./ru-4WxRouIU.cjs")).then(e=>e.ru),sk:()=>Promise.resolve().then(()=>require("./sk-uWukDQab.cjs")).then(e=>e.sk),sl:()=>Promise.resolve().then(()=>require("./sl-B6DVbKg6.cjs")).then(e=>e.sl),sr:()=>Promise.resolve().then(()=>require("./sr-BOD8Tc-D.cjs")).then(e=>e.sr),sv:()=>Promise.resolve().then(()=>require("./sv-B6nLuQr7.cjs")).then(e=>e.sv),th:()=>Promise.resolve().then(()=>require("./th-DmULV6uT.cjs")).then(e=>e.th),tr:()=>Promise.resolve().then(()=>require("./tr-BE5geTUC.cjs")).then(e=>e.tr),uk:()=>Promise.resolve().then(()=>require("./uk-DS5ukB_-.cjs")).then(e=>e.uk),vi:()=>Promise.resolve().then(()=>require("./vi-D9FF4kkG.cjs")).then(e=>e.vi),zh:()=>Promise.resolve().then(()=>require("./zh-CGcOiJ3s.cjs")).then(e=>e.zh)},u=new Set(["ar","he","fa","ur"]);class c{constructor(e){r(this,"_locale"),r(this,"_isRtl"),r(this,"_loadedBundles"),r(this,"_overrides"),this._locale=e||c.detectLocale(),this._isRtl=c.isRtlLocale(this._locale),this._loadedBundles=new Map,this._loadedBundles.set("en",n),this._overrides={}}get locale(){return this._locale}get isRtl(){return this._isRtl}getStrings(){const e=this.getLanguageKey(this._locale),r=this._loadedBundles.get(e)||n;if("en"===e&&0===Object.keys(this._overrides).length)return n;let t=n;return"en"!==e&&(t=a(n,r)),Object.keys(this._overrides).length>0&&(t=a(t,this._overrides)),t}getComponentStrings(e){return this.getStrings()[e]}async loadBundle(e){const r=this.getLanguageKey(e);if("en"===r)return;if(this._loadedBundles.has(r))return;const t=l[r];if(t)try{const e=await t();this._loadedBundles.set(r,e)}catch(s){console.warn(`[DefaultLocalizationProvider] Failed to load bundle for locale "${r}". Falling back to English.`,s)}else console.warn(`[DefaultLocalizationProvider] No bundle available for locale "${r}". Using English.`)}setOverrides(e){this._overrides=e}async setLocale(e){this._locale=e,this._isRtl=c.isRtlLocale(e),await this.loadBundle(e)}static detectLocale(){return"undefined"!=typeof navigator&&navigator.language?navigator.language:"en"}static detectLocaleFromCulture(e){return(null==e?void 0:e.currentUICultureName)?e.currentUICultureName:(null==e?void 0:e.currentCultureName)?e.currentCultureName:c.detectLocale()}static isRtlLocale(e){const r=e.split("-")[0].toLowerCase();return u.has(r)}getLanguageKey(e){return e.split("-")[0].toLowerCase()}}const h=s.createContext(void 0),d=()=>{const e=s.useContext(h);return(null==e?void 0:e.strings)??n};function g(e){return d()[e]}exports.DefaultLocalizationProvider=c,exports.ErrorType=i,exports.LocalizationProvider=({provider:e,locale:r,overrides:o,children:i})=>{const[n]=s.useState(()=>e||new c(r)),[a,l]=s.useState(()=>(o&&n.setOverrides(o),n.getStrings())),[u,d]=s.useState(n.locale),[g,m]=s.useState(n.isRtl);s.useEffect(()=>{let e=!1;return(async()=>{await n.loadBundle(n.locale),e||l(n.getStrings())})(),()=>{e=!0}},[]),s.useEffect(()=>{o&&(n.setOverrides(o),l(n.getStrings()))},[o]);const v=s.useCallback(async e=>{await n.setLocale(e),d(n.locale),m(n.isRtl),l(n.getStrings())},[n]),p={provider:n,strings:a,locale:u,isRtl:g,setLocale:v};return t.jsx(h.Provider,{value:p,children:i})},exports.LogLevel=o,exports.deepMerge=a,exports.en=n,exports.useAIAssistantStrings=()=>g("aiAssistant"),exports.useAISearchControlStrings=()=>g("aiSearchControl"),exports.useAppDashboardStrings=()=>g("appDashboard"),exports.useCalendarStrings=()=>g("calendar"),exports.useCommonStrings=()=>g("common"),exports.useComponentStrings=g,exports.useInputFieldStrings=()=>g("inputField"),exports.useItemPickerStrings=()=>g("itemPicker"),exports.useKpiStrings=()=>g("kpi"),exports.useListItemActivityStrings=()=>g("listItemActivity"),exports.useLocalization=()=>s.useContext(h),exports.useMensionsStrings=()=>g("mensions"),exports.useMermaidDiagramStrings=()=>g("mermaidDiagram"),exports.useNoKpiStrings=()=>g("noKpis"),exports.useSearchControlStrings=()=>g("searchControl"),exports.useShareDialogStrings=()=>g("shareDialog"),exports.useStrings=d,exports.useUserCardStrings=()=>g("userCard"),exports.useWorldMapStrings=()=>g("worldMap");
+//# sourceMappingURL=LocalizationProvider-BLjmybBa.cjs.map