repond/src/meta.ts

respond to items state in realtime

import { DiffInfo, EffectDef, EffectPhase, ItemType, PropName, PropValue, RefPropName, RefPropValue } from "./types";
import { ParamEffectsGroup } from "./usable/paramEffects";

// This is changes recorded from setStates, and addItem and removeItem
export type RecordedChanges = {
  itemTypesBool: { [type: string]: boolean };
  itemIdsBool: { [type: string]: { [itemId: string]: boolean } };
  itemPropsBool: { [type: string]: { [itemId: string]: { [itemProp: string]: boolean } } };
  somethingChanged: boolean;
};

export const initialRecordedChanges: () => RecordedChanges = () => ({
  itemTypesBool: {},
  itemIdsBool: {},
  itemPropsBool: {},
  somethingChanged: false,
});

export const EMPTY_RECORDED_CHANGES = initialRecordedChanges();

export const initialDiffInfo: UntypedDiffInfo = {
  itemTypesChanged: [],
  itemTypesWithAdded: [],
  itemTypesWithRemoved: [],
  itemsChanged: {},
  propsChanged: {},
  itemsAdded: {},
  itemsRemoved: {},
  itemTypesChangedBool: {},
  itemTypesWithAddedBool: {},
  itemTypesWithRemovedBool: {},
  itemsChangedBool: {},
  propsChangedBool: {},
  itemsAddedBool: {},
  itemsRemovedBool: {},
};

type PropsByItemType<T, K extends keyof T> = keyof NonNullable<T[K]>[keyof T[keyof T]];

type DiffInfo_PropsChanged<T = any> = {
  [key: string]: { [itemId: string]: PropsByItemType<T, any>[] } & { __all?: PropsByItemType<T, any>[] };
} & { __all?: string[] };
type DiffInfo_PropsChangedBool<T = any> = {
  [K in any]: {
    [itemId: string]: { [K_P in PropsByItemType<T, any>]: boolean };
  } & { __all?: { [K_P in PropsByItemType<T, any>]: boolean } };
} & { __all?: { [K_P in string]: boolean } };

export type UntypedDiffInfo = {
  itemTypesChanged: [];
  itemTypesWithAdded: [];
  itemTypesWithRemoved: [];
  itemsChanged: { [type: string]: string[] };
  itemsAdded: { [type: string]: string[] };
  itemsRemoved: { [type: string]: string[] };
  propsChanged: DiffInfo_PropsChanged;
  itemTypesChangedBool: { [type: string]: boolean };
  itemTypesWithAddedBool: { [type: string]: boolean };
  itemTypesWithRemovedBool: { [type: string]: boolean };
  itemsChangedBool: { [type: string]: { [itemId: string]: boolean } };
  propsChangedBool: DiffInfo_PropsChangedBool;
  itemsAddedBool: { [type: string]: { [itemId: string]: boolean } };
  itemsRemovedBool: { [type: string]: { [itemId: string]: boolean } };
};

type AFunction = (...args: any[]) => void;

export type RepondMetaPhase =
  | "waitingForFirstUpdate"
  | "waitingForMoreUpdates"
  | "runningUpdates"
  | "runningEffects"
  | "runningStepEndEffects"
  | "runningCallbacks"; // might need more metaPhases for the different types of callbacks

export const repondMeta = {
  // Items -----------------------------------------------------
  prevState: {} as any,
  nowState: {} as any,
  nowRefs: {} as any,
  stepNames: ["default"] as const as Readonly<string[]>,

  // Live info -----------------------------------------------------
  nowStepName: "default" as Readonly<string>,
  nowStepIndex: 0,
  nowEffectPhase: "duringStep" as EffectPhase,
  isFirstDuringPhaseLoop: true,
  nowMetaPhase: "waitingForFirstUpdate" as RepondMetaPhase,
  willAddItemsInfo: {} as { [itemTypeName: string]: { [itemId: string]: any } },
  willRemoveItemsInfo: {} as { [itemTypeName: string]: { [itemId: string]: any } },
  isRunningSetStates: false,
  didInit: false,
  didStartFirstFrame: false, // so we can add items instantly before the first frame

  // Recording changes -----------------------------------------------------
  diffInfo: initialDiffInfo as unknown as DiffInfo,
  // this gets reset for each step (might not still be true)
  recordedEffectChanges: initialRecordedChanges(), // resets every time a steps derive listeners run, only records changes made while deriving?
  // this gets reset at the start of a frame, and kept added to throughout the frame
  recordedStepEndEffectChanges: initialRecordedChanges(),

  //
  // recordedPropIdsChanged_duringStep: {},
  // recordedPropIdsChanged_endOfStep: {},
  recordedPropIdsChangedMap: { duringStep: {}, endOfStep: {} } as Record<EffectPhase, Record<string, boolean>>,

  // Frames -----------------------------------------------------
  nextFrameIsFirst: true, // when the next frame is the first in a chain of frames
  previousFrameTime: 0,
  latestFrameTime: 0,
  latestFrameDuration: 16.66667,
  shouldRunUpdateAtEndOfUpdate: false,

  // Callback queues -----------------------------------------------------
  addAndRemoveItemsQueue: [] as AFunction[],
  effectsRunAtStartQueue: [] as AFunction[],
  startEffectsQueue: [] as AFunction[],
  setStatesQueue: [] as AFunction[],
  nextTickQueue: [] as AFunction[],

  // Effects -----------------------------------------------------
  autoEffectIdCounter: 1,
  // Normal effects
  liveEffectsMap: {} as Record<string, EffectDef>,
  // effectIdsByPhaseByStep: { duringStep: {}, endOfStep: {} } as Record<
  //   EffectPhase,
  //   Record<string, string[]> //  phase : stepName : listenerNames[]  // derive: checkInput: ['whenKeyboardPressed']
  // >,
  effectIdsByPhaseByStepByPropId: { duringStep: {}, endOfStep: {} } as Record<
    EffectPhase,
    Record<string, Record<string, string[]>> //  phase : stepName : : propPathId : listenerNames[]  // derive: checkInput: ['whenKeyboardPressed']
  >,
  storedEffectsMap: {} as Record<string, EffectDef>,
  effectIdsByGroup: {} as Record<string, string[]>, // effectGroup: [effectId]
  // Param effects
  allParamEffectGroups: {} as Record<string, ParamEffectsGroup<any, any>>,
  paramEffectIdsByGroupPlusParamKey: {} as Record<string, string[]>, // effectGroup: {paramKey: [effectId]}
  //
  // propIdsChangedInSetStateByPhaseByStep: { duringStep: {}, endOfStep: {} } as Record<
  //   EffectPhase,
  //   Record<string, string[]>
  // >, // phase: stepName: propPathId[]

  // Cached info -----------------------------------------------------
  itemTypeNames: [] as ItemType[],
  propNamesByItemType: {} as { [itemTypeName: string]: string[] },
  itemIdsByItemType: {} as { [itemTypeName: string]: string[] }, // current item names only, not previous..
  prevItemIdsByItemType: {} as { [itemTypeName: string]: string[] }, // this should be manually copied when the prevState is copied
  newRefsByItemType: {} as {[T in ItemType]?: (itemId?: string, itemState?: any) => { [K in RefPropName<T>]: RefPropValue<T, K> };
  },
  newStateByItemType: {} as {[T in ItemType]: (itemId?: string) => { [K in PropName<T>]: PropValue<T, K> };
  },
  // PropPathId info
  itemTypeByPropPathId: {} as Record<string, ItemType>, // For propPathId like pieces.piecePropertyA and alsp pieces.__added
  propKeyByPropPathId: {} as Record<string, string>, // To get "piecePropertyA" from "pieces.piecePropertyA" quickly ( in O(1) time )
  specialKeyByPropPathId: {} as Record<string, string>, // For special keys like __added, __removed
};

export type RepondMeta = typeof repondMeta;