semiotic 3.3.1 → 3.4.1

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

@@ -1,3 +1,11 @@
+/**
+ * Mock 2D canvas rendering context — structurally a `Partial<CanvasRenderingContext2D>`
+ * with method spies, plus a few extra stub fields. Typed as a loose stringy
+ * bag because vitest's `vi.fn()` return type doesn't line up with
+ * `CanvasRenderingContext2D`'s method signatures and tests inspect the spies
+ * directly via `ctx.fillRect.mock.calls` etc.
+ */
+export type CanvasContextMock = Record<string, unknown>;
 /**
  * Creates a mock 2D canvas rendering context with all commonly used
  * methods stubbed as vi.fn() and properties set to sensible defaults.
@@ -5,7 +13,33 @@
  * 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>;
+export declare function createMockCanvasContext(): CanvasContextMock;
+/**
+ * Record style state at the moment each draw op fires.
+ *
+ * Counting `ctx.fill` / `ctx.stroke` calls is brittle — a refactor that
+ * batches two paths into one stroke changes the count without changing
+ * what's visible. This helper instead captures the style state (`fillStyle`,
+ * `strokeStyle`, `globalAlpha`, `lineWidth`) at each draw call, so tests
+ * can assert on *what was drawn with what appearance* rather than on how
+ * many primitives the renderer emitted to get there.
+ *
+ * Usage:
+ *   const ctx = createMockCanvasContext()
+ *   const ops = recordCanvasOps(ctx)
+ *   someRenderer(ctx, nodes, ...)
+ *   expect(ops.fillStyles).toEqual(["#e41a1c", "rgba(255,255,0,0.5)"])
+ */
+export interface CanvasOpLog {
+    fillStyles: string[];
+    strokeStyles: string[];
+    fillAlphas: number[];
+    strokeAlphas: number[];
+    /** `lineWidth` at the moment each stroke fired — useful for pulse /
+     *  emphasis renderers that vary stroke weight by intensity. */
+    strokeLineWidths: number[];
+}
+export declare function recordCanvasOps(ctx: CanvasContextMock): CanvasOpLog;
 /**
  * Sets up the canvas getContext mock on HTMLCanvasElement.prototype,
  * mocks requestAnimationFrame to execute callbacks synchronously,

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

@@ -0,0 +1,48 @@
+/**
+ * Shared sample datasets for ordinal HOC chart tests (BarChart,
+ * StackedBarChart, GroupedBarChart). Previously defined locally in each
+ * test file with slight variations; this module is the single source of
+ * truth so shape changes (new fields, accessor renames) flow through every
+ * consumer at once.
+ */
+export interface BarDatum {
+    category: string;
+    value: number;
+}
+/** 3-point baseline used by most BarChart rendering tests. */
+export declare const BAR_SAMPLE: readonly BarDatum[];
+/** Smaller 2-point variant for initial-render / update-on-change tests. */
+export declare const BAR_INITIAL: readonly BarDatum[];
+/** Extended 3-point variant for "data changed" rerender tests. */
+export declare const BAR_EXTENDED: readonly BarDatum[];
+export interface NamedCountDatum {
+    name: string;
+    count: number;
+}
+/** `{name, count}` shape for verifying `categoryAccessor` / `valueAccessor` overrides. */
+export declare const NAMED_COUNT_DATA: readonly NamedCountDatum[];
+export interface ColoredBarDatum {
+    category: string;
+    value: number;
+    type: string;
+}
+/** Used for `colorBy="type"` legend-behavior tests. */
+export declare const BAR_COLORED: readonly ColoredBarDatum[];
+export interface StackedBarDatum {
+    category: string;
+    product: string;
+    value: number;
+}
+/**
+ * Used by both StackedBarChart and GroupedBarChart tests — same shape, same
+ * values; the only difference is whether the consumer passes `stackBy` or
+ * `groupBy`. Two categories × two products so stacking/grouping behavior is
+ * observable from the scene.
+ */
+export declare const STACKED_SAMPLE: readonly StackedBarDatum[];
+export interface GroupSeriesDatum {
+    group: string;
+    series: string;
+    count: number;
+}
+export declare const GROUP_SERIES_CUSTOM: readonly GroupSeriesDatum[];