@xplor-education/core-stencil-components 3.0.0 → 3.1.2

package/dist/types/test-utils/index.d.ts

@@ -0,0 +1,2 @@
+export { renderComponent, triggerEvent, triggerKeyboard, typeIntoInput, eventSpy } from './spec-helpers';
+export { createMockFile, mockBoundingClientRect, mockFetch, mockRequestAnimationFrame } from './mocks';

package/dist/types/test-utils/mocks.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Creates a mock File object for testing file upload components.
+ */
+export declare function createMockFile(name?: string, size?: number, type?: string, lastModified?: number): File;
+/**
+ * Mocks getBoundingClientRect for positioning tests (tooltip, picker, dropdown).
+ */
+export declare function mockBoundingClientRect(el: Element, rect?: Partial<DOMRect>): void;
+/**
+ * Mocks global fetch for API-calling components like xplor-assistant.
+ */
+export declare function mockFetch(response: any, ok?: boolean): jest.SpyInstance;
+/**
+ * Mocks requestAnimationFrame for JSDOM environments.
+ */
+export declare function mockRequestAnimationFrame(): void;

package/dist/types/test-utils/spec-helpers.d.ts

@@ -0,0 +1,26 @@
+import { SpecPage } from '@stencil/core/testing';
+/**
+ * Wraps newSpecPage to reduce boilerplate. Renders a single component with the given HTML.
+ */
+export declare function renderComponent(opts: {
+    components: any[];
+    html: string;
+    autoApplyChanges?: boolean;
+}): Promise<SpecPage>;
+/**
+ * Dispatches a DOM event on the given element and waits for Stencil to process changes.
+ */
+export declare function triggerEvent(page: SpecPage, el: Element, eventName: string, eventInit?: EventInit): Promise<void>;
+/**
+ * Dispatches a keyboard event on the given element and waits for changes.
+ */
+export declare function triggerKeyboard(page: SpecPage, el: Element, eventName: 'keydown' | 'keyup' | 'keypress', key: string, options?: Partial<KeyboardEventInit>): Promise<void>;
+/**
+ * Simulates typing into an input element by setting its value and dispatching an input event.
+ */
+export declare function typeIntoInput(page: SpecPage, input: HTMLInputElement | HTMLTextAreaElement, value: string): Promise<void>;
+/**
+ * Attaches a Jest spy to capture events emitted by a Stencil component.
+ * Returns the spy which can be used to check calls.
+ */
+export declare function eventSpy(el: Element, eventName: string): jest.Mock;