semiotic 3.0.0 → 3.1.0

package/dist/test-utils/canvasMock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Creates a mock 2D canvas rendering context with all commonly used
+ * methods stubbed as vi.fn() and properties set to sensible defaults.
+ *
+ * This is the single canonical canvas mock for the entire test suite.
+ * Import from "../../test-utils/canvasMock" (or appropriate relative path).
+ */
+export declare function createMockCanvasContext(): Record<string, any>;
+/**
+ * Sets up the canvas getContext mock on HTMLCanvasElement.prototype,
+ * mocks requestAnimationFrame to execute callbacks synchronously,
+ * and mocks cancelAnimationFrame.
+ *
+ * @returns A cleanup function that restores the mocked globals.
+ *
+ * @example
+ * ```ts
+ * let cleanup: () => void
+ * beforeEach(() => { cleanup = setupCanvasMock() })
+ * afterEach(() => { cleanup() })
+ * ```
+ */
+export declare function setupCanvasMock(): () => void;

package/dist/test-utils/frameMock.d.ts

@@ -0,0 +1,78 @@
+import * as React from "react";
+/**
+ * Creates a vi.mock factory for a Stream Frame module that captures
+ * the props passed to the frame component.
+ *
+ * The mock renders a simple div with the appropriate CSS class and
+ * an inner <svg /> element, matching the real frame's DOM structure.
+ *
+ * @param className - The CSS class the mock div should use
+ *   (e.g., "stream-ordinal-frame", "stream-network-frame", "stream-xy-frame").
+ * @returns An object with:
+ *   - `factory` — the mock module factory to pass to `vi.mock(path, factory)`
+ *   - `getLastProps()` — returns the most recent props passed to the frame
+ *   - `reset()` — clears captured props (call in beforeEach)
+ */
+export declare function createFrameMock(className: string): {
+    factory: () => {
+        __esModule: boolean;
+        default: (props: any) => React.DetailedReactHTMLElement<{
+            className: string;
+        }, HTMLElement>;
+    };
+    getLastProps: () => any;
+    reset: () => void;
+};
+/**
+ * Pre-built mock for StreamOrdinalFrame.
+ *
+ * Usage:
+ * ```ts
+ * import { ordinalFrameMock } from "../../test-utils/frameMock"
+ *
+ * vi.mock("../../stream/StreamOrdinalFrame", ordinalFrameMock.factory)
+ *
+ * beforeEach(() => ordinalFrameMock.reset())
+ *
+ * it("passes correct props", () => {
+ *   render(<BarChart data={data} />)
+ *   expect(ordinalFrameMock.getLastProps().chartType).toBe("bar")
+ * })
+ * ```
+ */
+export declare const ordinalFrameMock: {
+    factory: () => {
+        __esModule: boolean;
+        default: (props: any) => React.DetailedReactHTMLElement<{
+            className: string;
+        }, HTMLElement>;
+    };
+    getLastProps: () => any;
+    reset: () => void;
+};
+/**
+ * Pre-built mock for StreamNetworkFrame.
+ */
+export declare const networkFrameMock: {
+    factory: () => {
+        __esModule: boolean;
+        default: (props: any) => React.DetailedReactHTMLElement<{
+            className: string;
+        }, HTMLElement>;
+    };
+    getLastProps: () => any;
+    reset: () => void;
+};
+/**
+ * Pre-built mock for StreamXYFrame.
+ */
+export declare const xyFrameMock: {
+    factory: () => {
+        __esModule: boolean;
+        default: (props: any) => React.DetailedReactHTMLElement<{
+            className: string;
+        }, HTMLElement>;
+    };
+    getLastProps: () => any;
+    reset: () => void;
+};