patch: add cursor util

packages/shared/src/cursor.ts

@@ -0,0 +1,44 @@
+import asArray from 'asArray';
+import last from 'last';
+
+export function createCursor() {
+  const storage: { cursor: number[] } = {
+    cursor: [],
+  };
+
+  function addLevel(): void {
+    storage.cursor.push(0);
+  }
+
+  function removeLevel(): void {
+    storage.cursor.pop();
+  }
+
+  function cursorAt(): number {
+    return last(storage.cursor);
+  }
+
+  function getCursor(): number[] {
+    return asArray(storage.cursor);
+  }
+
+  function next(): number {
+    storage.cursor[storage.cursor.length - 1]++;
+    return last(storage.cursor);
+  }
+
+  function reset(): void {
+    storage.cursor = [0];
+  }
+
+  reset();
+
+  return {
+    addLevel,
+    cursorAt,
+    getCursor,
+    next,
+    removeLevel,
+    reset,
+  };
+}

packages/vest/src/core/ctx/ctx.ts

@@ -1,5 +1,6 @@
 import assign from 'assign';
 import { createContext } from 'context';
+import { createCursor } from 'cursor';
 
 import VestTest from 'VestTest';
 import type { TStateRef } from 'createStateRef';
@@ -10,7 +11,7 @@ export default createContext<CTXType>((ctxRef, parentContext) =>
     : assign(
         {},
         {
-          cursorAt: [0],
+          testCursor: createCursor(),
           exclusion: {
             tests: {},
             groups: {},
@@ -21,7 +22,7 @@ export default createContext<CTXType>((ctxRef, parentContext) =>
 );
 
 type CTXType = {
-  cursorAt: number[];
+  testCursor: ReturnType<typeof createCursor>;
   stateRef?: TStateRef;
   exclusion: {
     tests: Record<string, boolean>;

packages/vest/src/core/ctx/testCursor.ts

@@ -0,0 +1,21 @@
+import ctx from 'ctx';
+
+export function useTestCursorAt(): number {
+  const context = ctx.useX();
+  return context.testCursor.cursorAt();
+}
+
+export function moveTestCursorForward(): number {
+  const context = ctx.useX();
+  return context.testCursor.next();
+}
+
+export function addTestCursorLevel(): void {
+  const context = ctx.useX();
+  context.testCursor.addLevel();
+}
+
+export function removeTestCursorLevel(): void {
+  const context = ctx.useX();
+  context.testCursor.removeLevel();
+}

packages/vest/src/core/test/lib/registerPrevRunTest.ts

@@ -2,24 +2,24 @@ import isPromise from 'isPromise';
 
 import VestTest from 'VestTest';
 import cancelOverriddenPendingTest from 'cancelOverriddenPendingTest';
-import { moveCursorAtForward } from 'cursorAt';
 import { isExcluded } from 'exclusive';
 import registerTest from 'registerTest';
 import runAsyncTest from 'runAsyncTest';
+import { moveTestCursorForward } from 'testCursor';
 import { useTestAtCursor, useSetTestAtCursor } from 'useTestAtCursor';
 
 export default function registerPrevRunTest(testObject: VestTest): VestTest {
   const prevRunTest = useTestAtCursor(testObject);
   if (isExcluded(testObject)) {
     testObject.skip();
-    moveCursorAtForward();
+    moveTestCursorForward();
     return prevRunTest;
   }
 
   cancelOverriddenPendingTest(prevRunTest, testObject);
 
   useSetTestAtCursor(testObject);
-  moveCursorAtForward();
+  moveTestCursorForward();
 
   registerTestObjectByTier(testObject);
 

packages/vest/src/core/test/lib/useTestAtCursor.ts

@@ -4,9 +4,9 @@ import removeElementFromArray from 'removeElementFromArray';
 import { throwErrorDeferred } from 'throwError';
 
 import VestTest from 'VestTest';
-import { useCursorAt } from 'cursorAt';
 import isSameProfileTest from 'isSameProfileTest';
 import { usePrevTestObjects, useTestObjects } from 'stateHooks';
+import { useTestCursorAt } from 'testCursor';
 
 export function useTestAtCursor(newTestObject: VestTest): VestTest {
   const [, setPrevTestObjects] = usePrevTestObjects();
@@ -39,7 +39,7 @@ export function useTestAtCursor(newTestObject: VestTest): VestTest {
 }
 
 export function useSetTestAtCursor(testObject: VestTest): void {
-  const cursorAt = useCursorAt();
+  const cursorAt = useTestCursorAt();
   const [testObjects, setTestObjects] = useTestObjects();
 
   if (testObject === testObjects[cursorAt]) {
@@ -54,7 +54,7 @@ export function useSetTestAtCursor(testObject: VestTest): void {
 }
 
 function useGetTestAtCursor(): VestTest {
-  const cursorAt = useCursorAt();
+  const cursorAt = useTestCursorAt();
   const [prevTestObjects] = usePrevTestObjects();
 
   return prevTestObjects[cursorAt];

packages/vest/src/core/test/test.memo.ts

@@ -2,10 +2,10 @@ import createCache from 'cache';
 import { isNull } from 'isNull';
 
 import VestTest, { TTestFn } from 'VestTest';
-import { useCursorAt } from 'cursorAt';
 import registerPrevRunTest from 'registerPrevRunTest';
 import { useSuiteId } from 'stateHooks';
 import type { TTestBase } from 'test';
+import { useTestCursorAt } from 'testCursor';
 // eslint-disable-next-line max-lines-per-function
 export default function bindTestMemo(test: TTestBase): {
   (fieldName: string, test: TTestFn, deps: unknown[]): VestTest;
@@ -35,7 +35,7 @@ export default function bindTestMemo(test: TTestBase): {
       | [test: TTestFn, deps: unknown[]]
   ): VestTest {
     const [suiteId] = useSuiteId();
-    const cursorAt = useCursorAt();
+    const cursorAt = useTestCursorAt();
 
     const [deps, testFn, msg] = args.reverse() as [any[], TTestFn, string];