@adriansteffan/reactive 0.1.1 → 0.1.3

package/dist/mod.d.ts

@@ -1,7 +1,12 @@
 import { ComponentType } from 'react';
+import { CSSProperties } from 'react';
 import { default as default_2 } from 'react';
+import { ForwardRefExoticComponent } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+
+declare type ApertureShape = 'circle' | 'ellipse' | 'square' | 'rectangle';
 
 export declare function arrayFlattener(item: TrialData): any[];
 
@@ -93,6 +98,8 @@ declare interface DeviceInfo {
     hasMicrophone: boolean;
 }
 
+export declare type DimensionSpec = UniformSpec | NormalSpec | PoissonSpec;
+
 export declare function EnterFullscreen({ content, buttonText, next, data, updateStore, delayMs, }: {
     prolificCode?: string;
     content?: default_2.ReactNode;
@@ -138,6 +145,8 @@ export declare const getPlatform: () => Platform;
 
 export declare function getSimulation(type: string): ComponentSimulation | undefined;
 
+export declare function halton(count: number, specs: DimensionSpec[]): number[] | number[][];
+
 declare interface IfBlockItem {
     type: 'IF_BLOCK';
     cond: ConditionalFunction;
@@ -163,8 +172,18 @@ export declare const MicCheck: ({ next }: {
     next: (data: object) => void;
 }) => JSX_2.Element;
 
+export declare type NoiseMovement = 'randomTeleport' | 'randomWalk' | 'randomDirection';
+
 export declare const noopSimulate: SimulateFunction;
 
+export declare let normal: (mu: number, sigma: number) => number;
+
+export declare type NormalSpec = {
+    distribution: 'normal';
+    mean: number;
+    sd: number;
+};
+
 export declare function now(): number;
 
 export declare function orchestrateSimulation(config: RunSimulationConfig, scriptPath: string): Promise<void>;
@@ -202,6 +221,13 @@ export declare function PlainInput({ content, buttonText, className, next, updat
 
 export declare type Platform = 'desktop' | 'mobile' | 'web';
 
+export declare let poisson: (lambda: number) => number;
+
+export declare type PoissonSpec = {
+    distribution: 'poisson';
+    mean: number;
+};
+
 export declare function ProlificEnding({ prolificCode, data, updateStore }: {
     prolificCode?: string;
 } & BaseComponentProps): JSX_2.Element;
@@ -212,6 +238,96 @@ export declare function Quest({ next, surveyJson, customQuestions, }: {
     customQuestions?: ComponentsMap;
 }): JSX_2.Element;
 
+export declare const RandomDotKinematogram: (rawProps: RDKProps) => JSX_2.Element;
+
+export declare const RDKCanvas: ForwardRefExoticComponent<RDKCanvasProps & RefAttributes<RDKCanvasHandle>>;
+
+export declare interface RDKCanvasHandle {
+    getStats: () => {
+        framesDisplayed: number;
+        measuredRefreshRate: number | null;
+    };
+}
+
+export declare interface RDKCanvasProps {
+    width: number;
+    height: number;
+    dotCount?: number;
+    dotSetCount?: number;
+    direction?: number;
+    coherence?: number;
+    opposite?: number;
+    speed?: number;
+    dotLifetime?: number;
+    updateRate?: number;
+    dotRadius?: number;
+    dotCharacter?: string;
+    dotColor?: string;
+    coherentDotColor?: string;
+    backgroundColor?: string;
+    apertureShape?: ApertureShape;
+    apertureWidth?: number;
+    apertureHeight?: number;
+    apertureCenterX?: number;
+    apertureCenterY?: number;
+    reinsertMode?: ReinsertType;
+    noiseMovement?: NoiseMovement;
+    reassignEveryMs?: number;
+    showFixation?: boolean;
+    fixationWidth?: number;
+    fixationHeight?: number;
+    fixationColor?: string;
+    fixationThickness?: number;
+    showBorder?: boolean;
+    borderWidth?: number;
+    borderColor?: string;
+    /** When true (default), dots are animated and visible. When false, only background (+ fixation if enabled) is shown. */
+    active?: boolean;
+    /** Seed the refresh-rate estimator (e.g. from a prior calibration). */
+    initialRefreshRate?: number;
+    style?: CSSProperties;
+    className?: string;
+}
+
+export declare interface RDKProps extends BaseComponentProps {
+    validKeys?: string[];
+    correctResponse?: string | string[];
+    duration?: number;
+    stimulusDuration?: number;
+    responseEndsTrial?: boolean;
+    dotCount?: number;
+    dotSetCount?: number;
+    direction?: number;
+    coherence?: number;
+    opposite?: number;
+    speed?: number;
+    dotLifetime?: number;
+    updateRate?: number;
+    dotRadius?: number;
+    dotCharacter?: string;
+    dotColor?: string;
+    coherentDotColor?: string;
+    backgroundColor?: string;
+    apertureShape?: ApertureShape;
+    apertureWidth?: number;
+    apertureHeight?: number;
+    apertureCenterX?: number;
+    apertureCenterY?: number;
+    reinsertMode?: ReinsertType;
+    noiseMovement?: NoiseMovement;
+    reassignEveryMs?: number;
+    showFixation?: boolean;
+    fixationTime?: number;
+    fixationWidth?: number;
+    fixationHeight?: number;
+    fixationColor?: string;
+    fixationThickness?: number;
+    showBorder?: boolean;
+    borderWidth?: number;
+    borderColor?: string;
+    responseHint?: string;
+}
+
 /**
  * Registers array methods on the Array prototype.
  * Call this function once to make array methods available globally.
@@ -240,6 +356,8 @@ export declare function registerFlattener(type: string, csv: string | null, flat
 
 export declare function registerSimulation(type: string, simulate: SimulateFunction, defaultSimulators: Record<string, any>): void;
 
+declare type ReinsertType = 'random' | 'opposite' | 'oppositeSimple' | 'wrap';
+
 export declare function RequestFilePermission({ next }: BaseComponentProps): JSX_2.Element | null;
 
 export declare function resolveSimulation(content: any, data: TrialResult[], store: Store_2): {
@@ -252,7 +370,9 @@ export declare interface RunSimulationConfig {
     participants: ParticipantState[] | {
         generator: (index: number) => ParticipantState;
         count: number;
-    };
+    } | (() => ParticipantState[]);
+    /** Seed for reproducible simulations. Each participant gets seed + workerIndex. */
+    seed?: number;
     backendPort?: number;
     concurrency?: number;
 }
@@ -262,6 +382,14 @@ export declare interface RunSimulationConfig {
  */
 export declare function sample<T>(array: T[], n?: number): T[];
 
+export declare function sampleParticipants<T extends Record<string, DimensionSpec>>(method: SamplingMethod, count: number, specs: T): Array<{
+    [K in keyof T]: number;
+}>;
+
+export declare type SamplingMethod = 'sobol' | 'halton' | 'random';
+
+export declare function seedDistributions(seed: number): void;
+
 export declare function setBackendUrl(url: string): void;
 
 /**
@@ -283,6 +411,8 @@ export declare type SimulatorResult = {
     duration?: number;
 };
 
+export declare function sobol(count: number, specs: DimensionSpec[]): number[] | number[][];
+
 export declare interface Store {
     [key: string]: any;
 }
@@ -321,6 +451,30 @@ export declare interface TrialData {
 
 declare type TrialResult = ComponentResultData | CanvasResultData;
 
+export declare const Tutorial: ({ next, slides, fadeDuration, finishText, containerClass, nextKey, backKey, theme, }: TutorialProps) => JSX_2.Element;
+
+export declare interface TutorialProps extends BaseComponentProps {
+    slides: ReactNode[];
+    /** Fade duration in seconds (default: 0.3) */
+    fadeDuration?: number;
+    finishText?: string;
+    containerClass?: string;
+    /** Key to go forward (default: 'ArrowRight', set to false to disable) */
+    nextKey?: string | false;
+    /** Key to go back (default: 'ArrowLeft', set to false to disable) */
+    backKey?: string | false;
+    /** Color mode for dot indicators (default: 'light') */
+    theme?: 'light' | 'dark';
+}
+
+export declare let uniform: (min: number, max: number) => number;
+
+export declare type UniformSpec = {
+    distribution: 'uniform';
+    min: number;
+    max: number;
+};
+
 declare interface UpdateStoreItem {
     type: 'UPDATE_STORE';
     fun: StoreUpdateFunction;
@@ -335,6 +489,21 @@ export declare function Upload({ data, next, store, sessionID, generateFiles, se
     androidFolderName?: string;
 }): JSX_2.Element;
 
+/**
+ * Hook for interactive slide components.
+ * Call with `{ locked: true }` to start with the next button disabled.
+ * Then call `unlock()` when the interaction is complete.
+ * Call `unlock({ autoAdvanceMs: 1000 })` to auto-advance after a delay.
+ */
+export declare const useTutorialSlide: ({ locked }?: {
+    locked?: boolean | undefined;
+}) => {
+    setData: (data: Record<string, unknown>) => void;
+    unlock: ({ autoAdvanceMs }?: {
+        autoAdvanceMs?: number;
+    }) => void;
+};
+
 declare interface WhileBlockItem {
     type: 'WHILE_BLOCK';
     cond: ConditionalFunction;

package/dist/reactive.es.js

@@ -1,53 +1,64 @@
-import { H as e, C as t, a as r, c as i, d as n, e as o, f as l, Y as m, z as c, M as u, P as p, g as P, h as g, Q as x, R as d, F as k, T as C, i as E, U as F, X as S, j as T, k as f, l as h, m as v, n as B, o as y, p as I, q as U, r as w, s as D, t as R, u as q, v as A, w as M, x as Q, y as Z, A as b, B as j, D as z, G, I as H, J, K, L, N, O, S as V, V as X, Z as Y, _ } from "./mod-Beb0Bz3s.js";
+import { H as e, C as t, a as i, c as n, d as r, e as o, f as l, Y as m, z as u, M as c, P as p, g as P, h as g, Q as d, R as x, i as C, j as T, F as k, T as E, k as F, l as S, U as f, X as h, m as v, n as B, o as D, p as R, q as y, r as I, s as U, t as b, u as w, v as K, w as q, x as A, y as M, A as Q, B as Z, D as j, G as z, I as G, J as H, K as J, L, N, O, S as V, V as X, Z as Y, _, $, a0 as W, a1 as aa, a2 as sa, a3 as ea, a4 as ta, a5 as ia, a6 as na, a7 as ra, a8 as oa, a9 as la } from "./mod-DRCLdWzq.js";
 export {
   e as Bounce,
   t as CanvasBlock,
-  r as CheckDevice,
-  i as EnterFullscreen,
-  n as ExitFullscreen,
+  i as CheckDevice,
+  n as EnterFullscreen,
+  r as ExitFullscreen,
   o as ExperimentProvider,
   l as ExperimentRunner,
   m as Flip,
-  c as Icons,
-  u as MicCheck,
+  u as Icons,
+  c as MicCheck,
   p as Param,
   P as PlainInput,
   g as ProlificEnding,
-  x as Quest,
-  d as RequestFilePermission,
+  d as Quest,
+  x as RDKCanvas,
+  C as RandomDotKinematogram,
+  T as RequestFilePermission,
   k as Slide,
-  C as Text,
-  E as ToastContainer,
-  F as Upload,
-  S as Zoom,
-  T as arrayFlattener,
-  f as canvasCountdown,
-  h as chunk,
-  v as collapseToast,
-  B as cssTransition,
-  y as getBackendUrl,
-  I as getInitialParticipant,
-  U as getParam,
+  E as Text,
+  F as ToastContainer,
+  S as Tutorial,
+  f as Upload,
+  h as Zoom,
+  v as arrayFlattener,
+  B as canvasCountdown,
+  D as chunk,
+  R as collapseToast,
+  y as cssTransition,
+  I as getBackendUrl,
+  U as getInitialParticipant,
+  b as getParam,
   w as getPlatform,
-  D as getSimulation,
-  R as isDesktop,
-  q as isFullscreen,
-  A as noopSimulate,
-  M as now,
-  Q as orchestrateSimulation,
-  Z as pipe,
-  b as registerArrayExtensions,
-  j as registerComponentParams,
-  z as registerExperimentParams,
-  G as registerFlattener,
-  H as registerSimulation,
-  J as resolveSimulation,
-  K as sample,
-  L as setBackendUrl,
-  N as shuffle,
-  O as simulateParticipant,
-  V as subsetExperimentByParam,
-  X as toast,
-  Y as useToast,
-  _ as useToastContainer
+  K as getSimulation,
+  q as halton,
+  A as isDesktop,
+  M as isFullscreen,
+  Q as noopSimulate,
+  Z as normal,
+  j as now,
+  z as orchestrateSimulation,
+  G as pipe,
+  H as poisson,
+  J as registerArrayExtensions,
+  L as registerComponentParams,
+  N as registerExperimentParams,
+  O as registerFlattener,
+  V as registerSimulation,
+  X as resolveSimulation,
+  Y as sample,
+  _ as sampleParticipants,
+  $ as seedDistributions,
+  W as setBackendUrl,
+  aa as shuffle,
+  sa as simulateParticipant,
+  ea as sobol,
+  ta as subsetExperimentByParam,
+  ia as toast,
+  na as uniform,
+  ra as useToast,
+  oa as useToastContainer,
+  la as useTutorialSlide
 };