@adriansteffan/reactive 0.0.43 → 0.1.0

package/dist/mod.d.ts

@@ -53,10 +53,17 @@ export declare function chunk<T>(array: T[], n: number): T[][];
 declare type ComponentResultData = BaseTrialData & {
     type: string;
     name: string;
+    /** Per-trial override for which CSV file(s) this trial's data goes into. When set on a timeline item, overrides the component type's default from the flattener registry. */
+    csv?: string | string[];
     responseData?: any;
     metadata?: Record<string, any>;
 };
 
+declare interface ComponentSimulation {
+    simulate: SimulateFunction;
+    defaultSimulators: Record<string, any>;
+}
+
 declare type ComponentsMap = {
     [key: string]: ComponentType<any>;
 };
@@ -65,16 +72,10 @@ declare type ComponentsMap_2 = {
     [key: string]: ComponentType<any>;
 };
 
-declare type ConditionalFunction = (data?: RefinedTrialData[], store?: Store_2) => boolean;
+declare type ConditionalFunction = (data?: TrialResult[], store?: Store_2) => boolean;
 
 declare type ControlFlowItem = MarkerItem | IfGotoItem | UpdateStoreItem | IfBlockItem | WhileBlockItem;
 
-declare type CSVBuilder = {
-    filename?: string;
-    trials?: string[];
-    fun?: (row: Record<string, any>) => Record<string, any>;
-};
-
 declare interface DeviceInfo {
     windowWidth: number;
     windowHeight: number;
@@ -105,16 +106,18 @@ export declare interface ExperimentConfig {
     showProgressBar: boolean;
 }
 
-export declare function ExperimentProvider({ children, disableSettings }: {
+export declare function ExperimentProvider({ children, disableSettings, disableHybridSimulation }: {
     children: ReactNode;
     disableSettings?: boolean;
+    disableHybridSimulation?: boolean;
 }): JSX_2.Element;
 
-export declare function ExperimentRunner({ timeline, config, components, questions, }: {
+export declare function ExperimentRunner({ timeline, config, components, questions, hybridParticipant, }: {
     timeline: TimelineItem[];
     config?: ExperimentConfig;
     components?: ComponentsMap_2;
     questions?: ComponentsMap_2;
+    hybridParticipant?: ParticipantState;
 }): JSX_2.Element;
 
 export declare interface FileUpload {
@@ -123,10 +126,16 @@ export declare interface FileUpload {
     encoding?: 'base64' | 'utf8';
 }
 
-export declare function getParam<T extends ParamType>(name: string, defaultValue: ParamValue<T>, type?: T, description?: string): ParamValue<T>;
+export declare function getBackendUrl(): string;
+
+export declare function getInitialParticipant(): ParticipantState | undefined;
+
+export declare function getParam<T extends ParamType>(name: string, defaultValue: ParamValue<T>, type?: T, description?: string, uiDefault?: string): ParamValue<T>;
 
 export declare const getPlatform: () => Platform;
 
+export declare function getSimulation(type: string): ComponentSimulation | undefined;
+
 declare interface IfBlockItem {
     type: 'IF_BLOCK';
     cond: ConditionalFunction;
@@ -152,8 +161,12 @@ export declare const MicCheck: ({ next }: {
     next: (data: object) => void;
 }) => JSX_2.Element;
 
+export declare const noopSimulate: SimulateFunction;
+
 export declare function now(): number;
 
+export declare function orchestrateSimulation(config: RunSimulationConfig, scriptPath: string): Promise<void>;
+
 export declare class Param {
     static getRegistry(): any[];
     static getTimelineRepresentation(): {
@@ -166,6 +179,8 @@ declare type ParamType = 'string' | 'number' | 'boolean' | 'array' | 'json';
 
 declare type ParamValue<T extends ParamType> = T extends 'number' ? number : T extends 'boolean' ? boolean : T extends 'array' | 'json' ? any : string;
 
+export declare type ParticipantState = Record<string, any>;
+
 /**
  * Applies a function to an array
  */
@@ -195,8 +210,6 @@ export declare function Quest({ next, surveyJson, customQuestions, }: {
     customQuestions?: ComponentsMap;
 }): JSX_2.Element;
 
-declare type RefinedTrialData = ComponentResultData | CanvasResultData;
-
 /**
  * Registers array methods on the Array prototype.
  * Call this function once to make array methods available globally.
@@ -221,25 +234,60 @@ export declare function registerComponentParams(type: string, params: {
 
 export declare function registerExperimentParams(experiment: any[]): void;
 
+export declare function registerFlattener(type: string, csv: string | null, flatten?: (item: TrialData) => any[]): void;
+
+export declare function registerSimulation(type: string, simulate: SimulateFunction, defaultSimulators: Record<string, any>): void;
+
 export declare function RequestFilePermission({ next }: BaseComponentProps): JSX_2.Element | null;
 
+export declare function resolveSimulation(content: any, data: TrialResult[], store: Store_2): {
+    trialProps: any;
+    simulateFn: any;
+    simulators: any;
+};
+
+export declare interface RunSimulationConfig {
+    participants: ParticipantState[] | {
+        generator: (index: number) => ParticipantState;
+        count: number;
+    };
+    backendPort?: number;
+    concurrency?: number;
+}
+
 /**
  * Returns random elements from an array
  */
 export declare function sample<T>(array: T[], n?: number): T[];
 
+export declare function setBackendUrl(url: string): void;
+
 /**
  * Shuffles array elements using Fisher-Yates algorithm
  */
 export declare function shuffle<T>(array: T[]): T[];
 
+export declare type SimulateFunction = (trialProps: Record<string, any>, experimentState: {
+    data: TrialResult[];
+    store: Store_2;
+}, simulators: Record<string, any>, participant: ParticipantState) => SimulatorResult | Promise<SimulatorResult>;
+
+export declare function simulateParticipant(timeline: TimelineItem[], participant: ParticipantState): Promise<TrialResult[]>;
+
+export declare type SimulatorResult = {
+    responseData: any;
+    participantState: ParticipantState;
+    storeUpdates?: Record<string, any>;
+    duration?: number;
+};
+
 export declare interface Store {
     [key: string]: any;
 }
 
 declare type Store_2 = Record<string, any>;
 
-declare type StoreUpdateFunction = (data?: RefinedTrialData[], store?: Store_2) => Record<string, any>;
+declare type StoreUpdateFunction = (data?: TrialResult[], store?: Store_2) => Record<string, any>;
 
 export declare function subsetExperimentByParam(experiment: any[]): any[];
 
@@ -261,27 +309,27 @@ export declare interface TrialData {
     trialNumber: number;
     type: string;
     name: string;
+    /** Populated from the timeline item's csv field. Overrides the component type's default CSV target from the flattener registry. */
+    csv?: string | string[];
     responseData: any;
     start: number;
     end: number;
     duration: number;
 }
 
+declare type TrialResult = ComponentResultData | CanvasResultData;
+
 declare interface UpdateStoreItem {
     type: 'UPDATE_STORE';
     fun: StoreUpdateFunction;
 }
 
-export declare function Upload({ data, next, store, sessionID, generateFiles, sessionCSVBuilder, trialCSVBuilder, uploadRaw, autoUpload, androidFolderName, }: BaseComponentProps & {
+export declare function Upload({ data, next, store, sessionID, generateFiles, sessionData, uploadRaw, autoUpload, androidFolderName, }: BaseComponentProps & {
     sessionID?: string | null;
-    generateFiles: (sessionID: string, data: TrialData[], store?: Store) => FileUpload[];
-    sessionCSVBuilder: CSVBuilder;
-    trialCSVBuilder: {
-        flatteners: Record<string, ((item: TrialData) => Record<string, any>[] | Record<string, Record<string, any>[]>)>;
-        builders: CSVBuilder[];
-    };
-    uploadRaw: boolean;
-    autoUpload: boolean;
+    generateFiles?: (sessionID: string, data: TrialData[], store?: Store) => FileUpload[];
+    sessionData?: Record<string, any>;
+    uploadRaw?: boolean;
+    autoUpload?: boolean;
     androidFolderName?: string;
 }): JSX_2.Element;
 

package/dist/reactive.es.js

@@ -1,42 +1,52 @@
-import { H as e, C as n, v as r, o as t, q as i, t as o, u as l, Y as c, z as m, M as p, P as u, l as P, m as x, Q as C, R as E, F as g, T, w as d, U as f, X as k, k as F, c as h, x as v, y as B, g as w, e as y, d as R, i as q, n as D, p as I, r as M, h as Q, f as U, s as b, a as j, j as z, B as A, N as H, L } from "./mod-D6W3wq3h.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 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";
 export {
   e as Bounce,
-  n as CanvasBlock,
-  r as CheckDevice,
-  t as EnterFullscreen,
-  i as ExitFullscreen,
+  t as CanvasBlock,
+  i as CheckDevice,
+  n as EnterFullscreen,
+  r as ExitFullscreen,
   o as ExperimentProvider,
   l as ExperimentRunner,
-  c as Flip,
-  m as Icons,
-  p as MicCheck,
-  u as Param,
+  m as Flip,
+  c as Icons,
+  u as MicCheck,
+  p as Param,
   P as PlainInput,
-  x as ProlificEnding,
-  C as Quest,
-  E as RequestFilePermission,
-  g as Slide,
-  T as Text,
-  d as ToastContainer,
-  f as Upload,
-  k as Zoom,
-  F as canvasCountdown,
-  h as chunk,
-  v as collapseToast,
-  B as cssTransition,
-  w as getParam,
-  y as getPlatform,
-  R as isDesktop,
-  q as isFullscreen,
-  D as now,
-  I as pipe,
-  M as registerArrayExtensions,
-  Q as registerComponentParams,
-  U as registerExperimentParams,
-  b as sample,
-  j as shuffle,
-  z as subsetExperimentByParam,
-  A as toast,
-  H as useToast,
-  L as useToastContainer
+  g as ProlificEnding,
+  x as Quest,
+  d 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
 };