@semiont/react-ui 0.4.20 → 0.4.22

package/dist/test-utils.d.mts

@@ -1,11 +1,10 @@
-import { ReactElement } from 'react';
+import React__default, { ReactElement } from 'react';
 import { RenderOptions, RenderResult } from '@testing-library/react';
 export * from '@testing-library/react';
-import { QueryClient } from '@tanstack/react-query';
-import { T as TranslationManager, e as KnowledgeBaseSessionValue, O as OpenResourcesManager } from './KnowledgeBaseSessionContext-BNNunwzO.mjs';
+import { SemiontBrowser, SemiontClient } from '@semiont/sdk';
 import { EventBus } from '@semiont/core';
+import { T as TranslationManager } from './TranslationManager-9Xj3MIWQ.mjs';
 export { vi } from 'vitest';
-import 'react/jsx-runtime';
 
 /**
  * Test utilities for @semiont/react-ui
@@ -14,21 +13,11 @@ import 'react/jsx-runtime';
  * for testing, with customizable mock implementations.
  */
 
-/**
- * Default mock context value for KnowledgeBaseSessionProvider in tests.
- * Tests override individual fields via `createMockKnowledgeBaseSession`.
- */
-declare const defaultMockKnowledgeBaseSession: KnowledgeBaseSessionValue;
-/**
- * Construct a mock KnowledgeBaseSession context value with overrides.
- */
-declare function createMockKnowledgeBaseSession(overrides?: Partial<KnowledgeBaseSessionValue>): KnowledgeBaseSessionValue;
 /**
  * Default mock implementations
  */
 declare const defaultMocks: {
     translationManager: TranslationManager;
-    openResourcesManager: OpenResourcesManager;
 };
 /**
  * Options for renderWithProviders
@@ -36,25 +25,63 @@ declare const defaultMocks: {
 interface TestProvidersOptions {
     translationManager?: TranslationManager;
     apiBaseUrl?: string;
-    knowledgeBaseSession?: KnowledgeBaseSessionValue;
-    openResourcesManager?: OpenResourcesManager;
-    queryClient?: QueryClient;
+    /** Inject a specific SemiontBrowser (e.g. one seeded with a kbs list). */
+    browser?: SemiontBrowser;
 }
 interface RenderWithProvidersOptions extends TestProvidersOptions, Omit<RenderOptions, 'wrapper'> {
-    /** If true, returns the event bus instance along with render result */
+    /**
+     * If true, returns the session (client) EventBus — session-scoped
+     * channels (mark:*, beckon:*, gather:*, match:*, bind:*, yield:*,
+     * browse:click, browse:reference-navigate, browse:entity-type-clicked).
+     */
     returnEventBus?: boolean;
+    /**
+     * If true, returns the app-scoped (SemiontBrowser) EventBus — panel:*,
+     * shell:*, tabs:*, nav:*, settings:*.
+     */
+    returnShellBus?: boolean;
 }
 interface RenderWithProvidersResult extends RenderResult {
+    /** Session-scoped bus (from the fake client inside the fake browser). */
     eventBus?: EventBus;
+    /** App-scoped bus (the fake browser's own bus). */
+    shellBus?: EventBus;
 }
 declare function renderWithProviders(ui: ReactElement, options?: RenderWithProvidersOptions): RenderWithProvidersResult;
+/**
+ * Build a minimal `<SemiontProvider>` wrapper for tests that roll their
+ * own render wrapper (instead of `renderWithProviders`). The returned
+ * `eventBus` is the bus backing the fake session's client — same
+ * reference production code pokes via `session.client.emit(...)`.
+ */
+declare function createTestSemiontWrapper(apiBaseUrl?: string): {
+    SemiontWrapper: React__default.ComponentType<{
+        children: React__default.ReactNode;
+    }>;
+    /** Session-scoped bus (from the fake client). */
+    eventBus: EventBus;
+    /** App-scoped bus (the fake browser's own bus). */
+    shellBus: EventBus;
+    /** The fake session's client — for tests that need to spy on namespace methods. */
+    client: SemiontClient;
+};
 /**
  * Create a mock translation manager with custom translations
  */
 declare function createMockTranslationManager(translations: Record<string, Record<string, string>>): TranslationManager;
 /**
- * Create a mock open resources manager with custom resources
+ * Build a fake SemiontBrowser with the active FrontendSessionSignals
+ * observables pre-populated. Used by SessionExpiredModal and
+ * PermissionDeniedModal tests that need to control the modal flags
+ * without driving a real session through its state machine.
  */
-declare function createMockOpenResourcesManager(resources?: OpenResourcesManager['openResources']): OpenResourcesManager;
+declare function createMockKnowledgeBaseSession(overrides?: {
+    permissionDeniedAt?: number | null;
+    permissionDeniedMessage?: string | null;
+    sessionExpiredAt?: number | null;
+    sessionExpiredMessage?: string | null;
+    acknowledgePermissionDenied?: () => void;
+    acknowledgeSessionExpired?: () => void;
+}): SemiontBrowser;
 
-export { type RenderWithProvidersOptions, type RenderWithProvidersResult, type TestProvidersOptions, createMockKnowledgeBaseSession, createMockOpenResourcesManager, createMockTranslationManager, defaultMockKnowledgeBaseSession, defaultMocks, renderWithProviders };
+export { type RenderWithProvidersOptions, type RenderWithProvidersResult, type TestProvidersOptions, createMockKnowledgeBaseSession, createMockTranslationManager, createTestSemiontWrapper, defaultMocks, renderWithProviders };