.

qwen/nodejs/node_modules/@jest/test-sequencer/build/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type {AggregatedResult} from '@jest/test-result';
+import type {Test} from '@jest/test-result';
+import type {TestContext} from '@jest/test-result';
+
+declare type Cache_2 = {
+  [key: string]:
+    | [testStatus: typeof FAIL | typeof SUCCESS, testDuration: number]
+    | undefined;
+};
+
+declare const FAIL = 0;
+
+export declare type ShardOptions = {
+  shardIndex: number;
+  shardCount: number;
+};
+
+declare const SUCCESS = 1;
+
+/**
+ * The TestSequencer will ultimately decide which tests should run first.
+ * It is responsible for storing and reading from a local cache
+ * map that stores context information for a given test, such as how long it
+ * took to run during the last run and if it has failed or not.
+ * Such information is used on:
+ * TestSequencer.sort(tests: Array<Test>)
+ * to sort the order of the provided tests.
+ *
+ * After the results are collected,
+ * TestSequencer.cacheResults(tests: Array<Test>, results: AggregatedResult)
+ * is called to store/update this information on the cache map.
+ */
+declare class TestSequencer {
+  private readonly _cache;
+  _getCachePath(testContext: TestContext): string;
+  _getCache(test: Test): Cache_2;
+  private _shardPosition;
+  /**
+   * Select tests for shard requested via --shard=shardIndex/shardCount
+   * Sharding is applied before sorting
+   *
+   * @param tests All tests
+   * @param options shardIndex and shardIndex to select
+   *
+   * @example
+   * ```typescript
+   * class CustomSequencer extends Sequencer {
+   *  shard(tests, { shardIndex, shardCount }) {
+   *    const shardSize = Math.ceil(tests.length / options.shardCount);
+   *    const shardStart = shardSize * (options.shardIndex - 1);
+   *    const shardEnd = shardSize * options.shardIndex;
+   *    return [...tests]
+   *     .sort((a, b) => (a.path > b.path ? 1 : -1))
+   *     .slice(shardStart, shardEnd);
+   *  }
+   * }
+   * ```
+   */
+  shard(
+    tests: Array<Test>,
+    options: ShardOptions,
+  ): Array<Test> | Promise<Array<Test>>;
+  /**
+   * Sort test to determine order of execution
+   * Sorting is applied after sharding
+   * @param tests
+   *
+   * ```typescript
+   * class CustomSequencer extends Sequencer {
+   *   sort(tests) {
+   *     const copyTests = Array.from(tests);
+   *     return [...tests].sort((a, b) => (a.path > b.path ? 1 : -1));
+   *   }
+   * }
+   * ```
+   */
+  sort(tests: Array<Test>): Array<Test> | Promise<Array<Test>>;
+  allFailedTests(tests: Array<Test>): Array<Test> | Promise<Array<Test>>;
+  cacheResults(tests: Array<Test>, results: AggregatedResult): void;
+  private hasFailed;
+  private time;
+}
+export default TestSequencer;
+
+export {};