@crownpeak/dqm-react-component 1.0.1 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-01-07
+
+### Added
+- **Internationalization (i18n)**: Full multi-language support using i18next
+  - Supported languages: English (default), German, Spanish
+  - Language switcher component in sidebar footer
+  - URL parameter override (`?dqmUiLang=de`)
+  - Browser language auto-detection
+  - LocalStorage persistence of user preference (`dqm_locale`)
+  - Regional variant fallbacks (e.g., `de-AT` → `de` → `en`)
+- **New Exports**: 
+  - `i18n`, `resolveLanguage` from `./i18n`
+  - `SUPPORTED_LOCALES`, `DEFAULT_LOCALE`, `normalizeLocale` from `./locale`
+  - Types: `SupportedLocale`, `AvailableLanguage`
+- **Comprehensive i18n documentation** in `I18N.md`
+
+## [1.1.0] - 2025-12-17
+
+### Added
+- **Overlay Configuration**: New `overlayConfig` option in `DQMConfig` for customizing overlay/toolbar detection
+  - `selector`: Custom CSS selector for overlay elements
+  - `validateIframe`: Option to validate iFrame contentWindow availability
+  - `pollMs`: Configurable polling interval for cross-origin iFrame detection
+  - `manualOffset`: Manual offset configuration for cases where auto-detection fails
+- **Enhanced `useDomPresence` Hook**: Now returns comprehensive element information including:
+  - `rect`: Element bounding rectangle (height, width, top, bottom, left, right)
+  - `position`: Detected position ('top', 'bottom', 'left', 'right', 'center')
+  - `contentOffset`: Ready-to-use offsets for positioning UI elements
+- **New Exports**: 
+  - `useOverlayResistant` hook for advanced overlay handling
+  - `OverlayConfig`, `OverlayOffsetPosition`, `OverlayInfo`, `OverlayPosition` types
+- **Standalone Widget Bundle**: New widget build (IIFE + ESM) with `initDQMWidget`, Shadow DOM isolation, and Emotion cache binding for safe embedding on any site.
+- **Widget Tooling & Types**: Added loader utilities, TypeScript declarations, and public exports for widget consumers.
+- **Integration Demos**: New demo pages for IIFE, ESM, dynamic loading, and standalone widget usage to test the bundled widget end-to-end.
+- **Config Option `disableLogout`**: Allows host apps to hide the sidebar logout control when session lifecycle is managed externally.
+
+### Changed
+- `useOverlayResistant` hook now accepts configuration options
+- `OverlayInfo` interface now includes `isManualOffset` flag
+- Sidebar header, content, footer, skeleton, and FAB now respect overlay offsets for consistent spacing around external toolbars.
+
 ## [1.0.1] - 2025-12-08
 
 ### Fixed

package/README.md

@@ -11,13 +11,15 @@ highlighting capabilities.
 
 ## 🌟 Features
 
+- **🤖 AI-Powered Translation & Summary** - Automatically translate analysis results into your language and generate intelligent summaries using OpenAI
 - **📊 Quality Analysis** - Comprehensive quality metrics and scores
 - **♿ Accessibility Checks** - WCAG compliance validation
 - **🎯 Error Highlighting** - Visual highlighting of issues in HTML
 - **🎨 Material-UI Design** - Beautiful, responsive sidebar interface
-- **🔐 OAuth 2.0 Authentication** - Secure Crownpeak SSO integration
+- **🔐 Secure Authentication** - Backend session management with secure credential storage
 - **⚡ Real-time Analysis** - Live quality assessment as you edit
 - **📱 Responsive** - Works on desktop, tablet, and mobile
+- **🌍 Internationalization** - Supports English, German, and Spanish
 - **🔧 TypeScript Support** - Full type definitions included
 
 ## 📦 Installation
@@ -63,17 +65,54 @@ function App() {
 export default App;
 ```
 
+### AI-Powered Translation & Summary (Quick Example)
+
+```typescript
+import {DQMSidebar} from '@crownpeak/dqm-react-component';
+
+<DQMSidebar
+    open={isOpen}
+    onClose={() => setIsOpen(false)}
+    onOpen={() => setIsOpen(true)}
+    config={{
+        websiteId: 'your-website-id',
+        apiKey: 'your-api-key',
+        // Enable AI Translation (API key via localStorage: dqm_openai_apiKey)
+        translation: {
+            enabledByDefault: true,
+            computeBudgetMs: 15000,   // 15s timeout for 'fast' mode
+        },
+        // Enable AI Summary (uses same OpenAI API key)
+        summary: {
+            timeoutMs: 30000,         // 30s timeout
+        }
+    }}
+/>
+```
+
+See **[AI Features Guide](./docs/AI-FEATURES.md)** for complete documentation including caching strategies and performance tuning.
+
 ## 📖 Documentation
 
-- **[Quick Start Guide](./QUICKSTART.md)** - Get up and running in 5 minutes
-- **[Examples](./EXAMPLES.md)** - Integration examples for React, Next.js, TypeScript
-- **[Authentication Guide](./AUTHENTICATION.md)** - OAuth 2.0 setup and configuration
-- **[Backend API](./BACKEND-API.md)** - API endpoints and usage
-- **[Development Guide](./DEVELOPMENT.md)** - Contributing and local development
+### Core Documentation
+- **[Quick Start Guide](./docs/QUICKSTART.md)** - Get up and running in 5 minutes
+- **[Examples](./docs/EXAMPLES.md)** - Integration examples for React, Next.js, TypeScript
+- **[Authentication Guide](./docs/AUTHENTICATION.md)** - Setup and configuration
+
+### AI Features
+- **[AI Features Guide](./docs/AI-FEATURES.md)** - Translation & Summary with OpenAI
+- **[API Reference](./docs/API-REFERENCE.md)** - Full TypeScript API documentation
+- **[Migration Guide](./docs/MIGRATION-GUIDE.md)** - Upgrade from v1.1 to v1.2
+
+### Advanced
+- **[Widget Guide](./docs/WIDGET-GUIDE.md)** - Standalone IIFE/ESM bundle usage
+- **[Backend API](./docs/BACKEND-API.md)** - Backend server endpoints and usage
+- **[Development Guide](./docs/DEVELOPMENT.md)** - Contributing and local development
+- **[Troubleshooting](./docs/TROUBLESHOOTING.md)** - Common issues and solutions
 
 ## 🔑 Authentication Setup
 
-The component requires authentication with Crownpeak DQM. 3 options are available:
+The component requires authentication with Crownpeak DQM. Two options are available:
 
 ```tsx
 import {DQMSidebar} from '@crownpeak/dqm-react-component';
@@ -81,22 +120,13 @@ import {DQMSidebar} from '@crownpeak/dqm-react-component';
 <DQMSidebar
     {/* ... */}
     config={{
-        // --  Direct API Key and Website ID (not recommended for production)
+        // Option 1: Direct API Key and Website ID (not recommended for production)
         // websiteId: 'your-website-id',
         // apiKey: 'your-api-key',
 
-        // -- Auth Backend for API Key management
-        authBackendUrl: 'http://localhost:3001',
+        // Option 2: Auth Backend for API Key management (recommended)
+        authBackendUrl: '', // Dev: empty (same origin) | Prod: 'https://your-backend.com'
         useLocalStorage: true,
-
-        // -- Oauth2:  backend not yet implemented ...
-        // oauth2Config: {
-        //     authUrl: 'https://dqm.crownpeak.com/oauth2/authorize',
-        //     clientId: 'crownpeak-dqm-react-component',
-        //     scope: 'dqm_api',
-        //     redirectUri: 'http://localhost:5173/',
-        //     tokenUrl: 'https://dqm.crownpeak.com/oauth2/token',
-        // }
     }}
 ```
 
@@ -121,10 +151,10 @@ npm run dev
 
 This starts:
 
-- Frontend on `http://localhost:5173`
-- Backend on `http://localhost:3001`
+- Frontend + Backend on `http://localhost:5173` (Vite dev server with integrated backend)
+- Backend routes (`/auth/*`, `/dqm/*`) handled by Vite plugin
 
-### Backend Requirements (Optional)
+### Standalone Server (Optional)
 
 If using the included backend server:
 
@@ -143,6 +173,71 @@ See [REDIS-SETUP.md](./REDIS-SETUP.md) for Redis installation.
 | `onClose`   | `() => void` | ✅        | Callback when sidebar closes |
 | `onOpen`    | `() => void` | ✅        | Callback when sidebar opens  |
 | `debugHtml` | `string`     | ❌        | HTML for testing (dev only)  |
+| `config`    | `DQMConfig`  | ❌        | Configuration options        |
+
+### DQMConfig Options
+
+| Option            | Type            | Default | Description                                    |
+|-------------------|-----------------|---------|------------------------------------------------|
+| `apiKey`          | `string`        | -       | Direct API key (not for production)            |
+| `websiteId`       | `string`        | -       | Website ID for DQM                             |
+| `authBackendUrl`  | `string`        | -       | Backend URL for session management             |
+| `useLocalStorage` | `boolean`       | `true`  | Persist credentials in localStorage            |
+| `disabled`        | `boolean`       | `false` | Disable DQM completely                         |
+| `disableLogout`   | `boolean`       | `false` | Hide the logout control (host manages session) |
+| `shadowDomMode`   | `boolean`       | `false` | Enable for Shadow DOM embedding                |
+| `overlayConfig`   | `OverlayConfig` | -       | Overlay/toolbar detection config               |
+
+### OverlayConfig (for Toolbars & Overlays)
+
+Configure how the sidebar adapts to fixed overlays (e.g., admin toolbars):
+
+```tsx
+<DQMSidebar
+    config={{
+        overlayConfig: {
+            // CSS selector for the overlay element
+            selector: 'iframe#MyToolbar',
+
+            // Validate iFrame has contentWindow (default: true)
+            validateIframe: true,
+
+            // Polling interval in ms for cross-origin iFrames (default: 1000)
+            pollMs: 1000,
+
+            // OR: Manual offset when auto-detection doesn't work
+            // (e.g., for iFrames that fill screen but have smaller internal content)
+            manualOffset: {
+                position: 'top', // 'top' | 'bottom' | 'left' | 'right'
+                pixels: 50
+            }
+        }
+    }}
+/>
+```
+
+**Common overlay configurations:**
+
+[//]: # (@formatter:off)
+```tsx
+// Disable overlay detection
+overlayConfig: {
+    selector: null
+}
+
+// Manual 50px offset from top
+overlayConfig: {
+    manualOffset: {
+        position: 'top', pixels: 50
+    }
+}
+
+// Custom selector without iFrame validation
+overlayConfig: {
+    selector: '.admin-toolbar', validateIframe: false
+}
+```
+[//]: # (@formatter:on)
 
 ### Exported Types
 
@@ -151,8 +246,15 @@ import type {
     AnalysisState,
     Checkpoint,
     AnalysisData,
-    DQMSidebarProps
+    DQMSidebarProps,
+    DQMConfig,
+    OverlayConfig,
+    OverlayOffsetPosition
 } from '@crownpeak/dqm-react-component';
+
+// For advanced overlay handling
+import {useOverlayResistant} from '@crownpeak/dqm-react-component';
+import type {OverlayInfo, OverlayPosition} from '@crownpeak/dqm-react-component';
 ```
 
 See [TypeScript examples](./EXAMPLES.md#typescript-configuration) for full type definitions.

package/dist/DQMSidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DQMSidebar.d.ts","sourceRoot":"","sources":["../src/DQMSidebar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAuC9D,OAAO,KAAK,EAA8B,eAAe,EAAc,MAAM,SAAS,CAAC;AAkBvF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA4oEhD,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"DQMSidebar.d.ts","sourceRoot":"","sources":["../src/DQMSidebar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiD,MAAM,OAAO,CAAC;AA4CtE,OAAO,KAAK,EAA8B,eAAe,EAAc,MAAM,SAAS,CAAC;AA0jFvF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAahD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/ErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../src/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;GAKG;AAEH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAc,SAAQ,KAAK,CAAC,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACxF,KAAK,EAAE,kBAAkB,CAMvB;IAEF,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS;IAO1D,kBAAkB,CAAC,SAAS,EAAE,kBAAkB;IAShD,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,mBAAmB,CAEzB;IAEF,MAAM;CAiEP;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,KAAK,CAAC,SAAS,EAAE,YAAY,OAAO,EAAE,4CAEjF,CAAC"}
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../src/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD;;;;;GAKG;AAEH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAc,SAAQ,KAAK,CAAC,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACxF,KAAK,EAAE,kBAAkB,CAMvB;IAEF,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS;IAO1D,kBAAkB,CAAC,SAAS,EAAE,kBAAkB;IAShD,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,mBAAmB,CAEzB;IAEF,MAAM;CAiEP;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,KAAK,CAAC,SAAS,EAAE,YAAY,OAAO,EAAE,4CAEjF,CAAC"}

package/dist/__tests__/setup.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=setup.d.ts.map

package/dist/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,kCAAkC,CAAC"}

package/dist/__tests__/utils.d.ts

@@ -0,0 +1,145 @@
+import { ReactElement } from 'react';
+import { RenderOptions, RenderResult } from '@testing-library/react';
+declare const rootReducer: import('redux').Reducer<{
+    locale: import('../store/localeSlice').LocaleState;
+    analysis: import('../store').AnalysisSliceState;
+    highlight: import('../store').HighlightSliceState;
+    auth: import('immer').WritableDraft<import('../store').AuthSliceState>;
+    ai: import('../store').AISliceState;
+    dqmApi: import('@reduxjs/toolkit/query').CombinedState<{
+        createAsset: import('@reduxjs/toolkit/query').MutationDefinition<import('../store').CreateAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').CreateAssetResponse, "dqmApi", unknown>;
+        getAsset: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store/api/dqmApi').TransformedAnalysisData, "dqmApi", unknown>;
+        getHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+        getAllHighlights: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAllHighlightsRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+        getCheckpointHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest & {
+            highlightSource?: boolean;
+        }, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", string, "dqmApi", unknown>;
+    }, "Highlight" | "Asset", "dqmApi">;
+}, import('redux').UnknownAction, Partial<{
+    locale: import('../store/localeSlice').LocaleState;
+    analysis: import('../store').AnalysisSliceState;
+    highlight: import('../store').HighlightSliceState;
+    auth: import('immer').WritableDraft<import('../store').AuthSliceState>;
+    ai: import('../store').AISliceState;
+    dqmApi: import('@reduxjs/toolkit/query').CombinedState<{
+        createAsset: import('@reduxjs/toolkit/query').MutationDefinition<import('../store').CreateAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').CreateAssetResponse, "dqmApi", unknown>;
+        getAsset: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store/api/dqmApi').TransformedAnalysisData, "dqmApi", unknown>;
+        getHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+        getAllHighlights: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAllHighlightsRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+        getCheckpointHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest & {
+            highlightSource?: boolean;
+        }, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", string, "dqmApi", unknown>;
+    }, "Highlight" | "Asset", "dqmApi">;
+}>>;
+export type TestRootState = ReturnType<typeof rootReducer>;
+/**
+ * Create a test store with optional preloaded state.
+ * Uses same configuration as the main store.
+ */
+export declare function createTestStore(preloadedState?: Partial<TestRootState>): import('@reduxjs/toolkit').EnhancedStore<{
+    locale: import('../store/localeSlice').LocaleState;
+    analysis: import('../store').AnalysisSliceState;
+    highlight: import('../store').HighlightSliceState;
+    auth: import('immer').WritableDraft<import('../store').AuthSliceState>;
+    ai: import('../store').AISliceState;
+    dqmApi: import('@reduxjs/toolkit/query').CombinedState<{
+        createAsset: import('@reduxjs/toolkit/query').MutationDefinition<import('../store').CreateAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').CreateAssetResponse, "dqmApi", unknown>;
+        getAsset: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store/api/dqmApi').TransformedAnalysisData, "dqmApi", unknown>;
+        getHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+        getAllHighlights: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAllHighlightsRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+        getCheckpointHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest & {
+            highlightSource?: boolean;
+        }, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", string, "dqmApi", unknown>;
+    }, "Highlight" | "Asset", "dqmApi">;
+}, import('redux').UnknownAction, import('@reduxjs/toolkit').Tuple<[import('redux').StoreEnhancer<{
+    dispatch: import('redux-thunk').ThunkDispatch<{
+        locale: import('../store/localeSlice').LocaleState;
+        analysis: import('../store').AnalysisSliceState;
+        highlight: import('../store').HighlightSliceState;
+        auth: import('immer').WritableDraft<import('../store').AuthSliceState>;
+        ai: import('../store').AISliceState;
+        dqmApi: import('@reduxjs/toolkit/query').CombinedState<{
+            createAsset: import('@reduxjs/toolkit/query').MutationDefinition<import('../store').CreateAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').CreateAssetResponse, "dqmApi", unknown>;
+            getAsset: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAssetRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store/api/dqmApi').TransformedAnalysisData, "dqmApi", unknown>;
+            getHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+            getAllHighlights: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetAllHighlightsRequest, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", import('../store').HighlightResponse, "dqmApi", unknown>;
+            getCheckpointHighlight: import('@reduxjs/toolkit/query').QueryDefinition<import('../store').GetHighlightRequest & {
+                highlightSource?: boolean;
+            }, import('@reduxjs/toolkit/query').BaseQueryFn<string | import('@reduxjs/toolkit/query').FetchArgs, unknown, import('@reduxjs/toolkit/query').FetchBaseQueryError, {}, import('@reduxjs/toolkit/query').FetchBaseQueryMeta>, "Highlight" | "Asset", string, "dqmApi", unknown>;
+        }, "Highlight" | "Asset", "dqmApi">;
+    }, undefined, import('redux').UnknownAction>;
+}>, import('redux').StoreEnhancer]>>;
+export type AppStore = ReturnType<typeof createTestStore>;
+/**
+ * Custom render that includes all providers
+ */
+interface CustomRenderOptions extends Omit<RenderOptions, 'wrapper'> {
+    preloadedState?: Partial<TestRootState>;
+    store?: ReturnType<typeof createTestStore>;
+}
+export declare function renderWithProviders(ui: ReactElement, { preloadedState, store, ...renderOptions }?: CustomRenderOptions): RenderResult & {
+    store: ReturnType<typeof createTestStore>;
+};
+/**
+ * Create mock credentials for testing
+ */
+export declare function createMockCredentials(overrides?: Partial<{
+    apiKey: string;
+    websiteId: string;
+}>): {
+    apiKey: string;
+    websiteId: string;
+};
+/**
+ * Create mock analysis data for testing
+ */
+export declare function createMockAnalysisData(overrides?: Partial<TestRootState['analysis']>): {
+    state: import('..').AnalysisState;
+    assetId: string | null;
+    data: import('..').AnalysisData | null;
+    error: string | null;
+    isAnalyzing: boolean;
+    startedAt: number | null;
+    completedAt: number | null;
+};
+/**
+ * Create mock checkpoint for testing
+ */
+export declare function createMockCheckpoint(overrides?: Partial<import('../types').Checkpoint>): {
+    colors: {
+        bg: string;
+        text: string;
+    };
+    id: string;
+    name: string;
+    description: string;
+    reference: string;
+    number: number;
+    categoryNumber: number;
+    category: string;
+    priority: boolean;
+    failed: boolean;
+    topics: string[];
+    canHighlight: {
+        page: boolean;
+        source: boolean;
+    };
+    restricted: boolean;
+    checkpointType: {
+        name: string;
+        modifiedBy: string;
+        modified: string;
+    };
+    created: string;
+    modified: string;
+};
+/**
+ * Wait for a condition to be true
+ */
+export declare function waitFor(condition: () => boolean, { timeout, interval }?: {
+    timeout?: number;
+    interval?: number;
+}): Promise<void>;
+export * from '@testing-library/react';
+export { default as userEvent } from '@testing-library/user-event';
+//# sourceMappingURL=utils.d.ts.map

package/dist/__tests__/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/__tests__/utils.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAc,EAAE,KAAK,YAAY,EAA0B,MAAM,OAAO,CAAC;AACzE,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAqBvF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOf,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAUtE;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAsB1D;;GAEG;AACH,UAAU,mBAAoB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;IAClE,cAAc,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;CAC5C;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,EACE,cAAc,EACd,KAAuC,EACvC,GAAG,aAAa,EACjB,GAAE,mBAAwB,GAC1B,YAAY,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;CAAE,CAM9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;YAA5B,MAAM;eAAa,MAAM;EAM5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;;;;;;;;EAWpF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,UAAU,EAAE,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBtF;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,OAAO,EACxB,EAAE,OAAc,EAAE,QAAc,EAAE;;;CAAK,GACtC,OAAO,CAAC,IAAI,CAAC,CAQf;AAGD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAC"}