@adriansteffan/reactive 0.1.0 → 0.1.2

package/dist/mod.d.ts

@@ -1,7 +1,14 @@
 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[];
 
 export declare interface BaseComponentProps {
     next: (data?: object, actualStartTime?: number, actualStopTime?: number) => void;
@@ -161,6 +168,8 @@ 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 function now(): number;
@@ -210,6 +219,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.
@@ -238,6 +337,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): {
@@ -319,6 +420,22 @@ 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';
+}
+
 declare interface UpdateStoreItem {
     type: 'UPDATE_STORE';
     fun: StoreUpdateFunction;
@@ -333,6 +450,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,52 +1,57 @@
-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 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 I, p as U, q as w, r as y, 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-D9lwPIrH.js";
+import { H as e, C as t, a as i, c as r, d as n, e as o, f as l, Y as m, z as u, M as c, P as p, g, h as P, 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 v, X as f, m as h, n as B, o as D, p as R, q as y, r as I, s as U, t as w, u as K, v as q, w as A, x as M, y as Q, A as Z, B as b, 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 } from "./mod-Bb_FAy0j.js";
 export {
   e as Bounce,
   t as CanvasBlock,
   i as CheckDevice,
-  n as EnterFullscreen,
-  r as ExitFullscreen,
+  r as EnterFullscreen,
+  n 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,
+  g as PlainInput,
+  P as ProlificEnding,
+  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 canvasCountdown,
-  f as chunk,
-  h as collapseToast,
-  v as cssTransition,
-  B as getBackendUrl,
-  I as getInitialParticipant,
-  U as getParam,
-  w as getPlatform,
-  y as getSimulation,
-  D as isDesktop,
-  R as isFullscreen,
-  q as noopSimulate,
-  A as now,
-  M as orchestrateSimulation,
-  Q as pipe,
-  Z as registerArrayExtensions,
-  b as registerComponentParams,
-  j as registerExperimentParams,
-  z as registerFlattener,
-  G as registerSimulation,
-  H as resolveSimulation,
-  J as sample,
-  K as setBackendUrl,
-  L as shuffle,
-  N as simulateParticipant,
-  O as subsetExperimentByParam,
-  V as toast,
-  X as useToast,
-  Y as useToastContainer
+  E as Text,
+  F as ToastContainer,
+  S as Tutorial,
+  v as Upload,
+  f as Zoom,
+  h as arrayFlattener,
+  B as canvasCountdown,
+  D as chunk,
+  R as collapseToast,
+  y as cssTransition,
+  I as getBackendUrl,
+  U as getInitialParticipant,
+  w as getParam,
+  K as getPlatform,
+  q as getSimulation,
+  A as isDesktop,
+  M as isFullscreen,
+  Q as noopSimulate,
+  Z as now,
+  b as orchestrateSimulation,
+  j as pipe,
+  z as registerArrayExtensions,
+  G as registerComponentParams,
+  H as registerExperimentParams,
+  J as registerFlattener,
+  L as registerSimulation,
+  N as resolveSimulation,
+  O as sample,
+  V as setBackendUrl,
+  X as shuffle,
+  Y as simulateParticipant,
+  _ as subsetExperimentByParam,
+  $ as toast,
+  W as useToast,
+  aa as useToastContainer,
+  sa as useTutorialSlide
 };