@midscene/test 1.15.6 → 1.16.1

package/dist/types/cli/index.d.ts

@@ -2,6 +2,8 @@ import { Awaitable } from '@midscene/core/internal/test-runner';
 import { CommonAgentTestRunnerApi } from '@midscene/core/agent/test';
 import type * as Core from '@midscene/core/internal/test-runner';
 import type { ExecutionProjectDefinition as ExecutionProjectDefinition_2 } from '@midscene/core/internal/test-runner';
+import { FileSetupContext } from '@midscene/core/internal/test-runner';
+import { FileSetupDefinition } from '@midscene/core/internal/test-runner';
 import type { IExecutionDump } from '@midscene/core';
 import { JsonPrimitive } from '@midscene/core/internal/test-runner';
 import { JsonValue } from '@midscene/core/internal/test-runner';
@@ -33,33 +35,41 @@ export declare const createTestRunId: (date?: Date, uuid?: `${string}-${string}-
 
 export declare const DEFAULT_TEST_FILE_SELECTION: TestFileSelection;
 
+export declare const defineFileSetup: <TContext, TProjectContext = unknown>(definition: FileSetupDefinition<TContext, TProjectContext>) => FileSetupDefinition<TContext, TProjectContext>;
+
 declare type DefineNodeOptions<TInput = unknown, TData = unknown, TContext = unknown> = Omit<Core.DefineNodeOptions<TInput, TData, TContext>, 'execute'> & {
     execute(ctx: NodeExecutionContext<TInput, TContext>): Core.NodeExecutionReturn<TData>;
 };
 
 export declare const defineProjectSetup: <TProjectContext>(definition: ProjectSetupDefinition<TProjectContext>) => ProjectSetupDefinition<TProjectContext>;
 
-export declare const defineTestProject: <TContext = undefined>(definition: TestProjectDefinition<TContext>) => TestProjectDefinition<TContext>;
+export declare const defineTestProject: <TContext = undefined, TProjectContext = TContext>(definition: TestProjectDefinition<TContext, TProjectContext>) => TestProjectDefinition<TContext, TProjectContext>;
 
 export declare const discoverTestConfig: (projectRoot: string) => string | undefined;
 
 export declare const discoverTestFiles: (projectRoot: string, selection?: TestFileSelection) => string[];
 
-export declare type ExecutionProjectDefinition<TContext = unknown> = Omit<ExecutionProjectDefinition_2<TContext>, 'nodes'> & {
+export declare type ExecutionProjectDefinition<TContext = unknown, TProjectContext = TContext> = Omit<ExecutionProjectDefinition_2<TProjectContext>, 'nodes' | 'fileSetup'> & {
+    fileSetup?: FileSetupDefinition<TContext, TProjectContext>;
     nodes?: readonly NodeDefinition<any, any, TContext>[];
 };
 
+export { FileSetupContext }
+
+export { FileSetupDefinition }
+
 export { JsonPrimitive }
 
 export { JsonValue }
 
-export declare interface LoadedExecutionProject<TProjectContext = unknown> extends ResolvedExecutionProject<TProjectContext> {
+export declare interface LoadedExecutionProject<TContext = unknown, TProjectContext = TContext> extends ResolvedExecutionProject<TProjectContext> {
+    readonly fileSetup?: FileSetupDefinition<TContext, TProjectContext>;
     /** Effective Nodes: globals plus project-local overrides. */
     readonly nodes: NodeRegistry;
 }
 
-export declare interface LoadedTestProject<TContext = undefined> {
-    projects: readonly LoadedExecutionProject<TContext>[];
+export declare interface LoadedTestProject<TContext = undefined, TProjectContext = TContext> {
+    projects: readonly LoadedExecutionProject<TContext, TProjectContext>[];
     hasExplicitProjects: boolean;
     test: ResolvedTestOptions;
     output: ResolvedTestOutputDefinition;
@@ -67,7 +77,7 @@ export declare interface LoadedTestProject<TContext = undefined> {
     resolveNode(name: string): NodeDefinition<any, any, TContext> | undefined;
 }
 
-export declare function loadTestProject<TContext = undefined>(configPath?: string): Promise<LoadedTestProject<TContext>>;
+export declare function loadTestProject<TContext = undefined, TProjectContext = TContext>(configPath?: string): Promise<LoadedTestProject<TContext, TProjectContext>>;
 
 declare interface MidsceneExecutionRef {
     id?: string;
@@ -126,7 +136,10 @@ export { ProjectTeardownContext }
 export { ResolvedExecutionProject }
 
 export declare interface ResolvedTestOptions {
-    maxConcurrency: number;
+    maxConcurrentFiles: number | null;
+    maxConcurrentProjects: number | null;
+    setupTimeout: number;
+    teardownTimeout: number;
     bail: number;
     testTimeout: number;
 }
@@ -161,7 +174,14 @@ export declare interface TestExecutionProjectRunResult {
 export { TestFileSelection }
 
 export declare interface TestOptions {
-    maxConcurrency?: number;
+    /** Global active files, including preparation and cleanup. Default 1; null is unlimited. */
+    maxConcurrentFiles?: number | null;
+    /** Projects from setup through completed cleanup. Default 1; null is unlimited. */
+    maxConcurrentProjects?: number | null;
+    /** Milliseconds for each Project setup/fileSetup, including device waits. */
+    setupTimeout?: number;
+    /** Milliseconds per cleanup scope; shared deadline during abnormal shutdown. */
+    teardownTimeout?: number;
     bail?: number;
     testTimeout?: number;
 }
@@ -182,9 +202,10 @@ export declare interface TestProjectCollectionError {
     error: WorkflowError;
 }
 
-export declare interface TestProjectDefinition<TContext = undefined> {
-    setup?: ProjectSetupDefinition<TContext>;
-    projects?: readonly ExecutionProjectDefinition<TContext>[];
+export declare interface TestProjectDefinition<TContext = undefined, TProjectContext = TContext> {
+    setup?: ProjectSetupDefinition<TProjectContext>;
+    fileSetup?: FileSetupDefinition<TContext, TProjectContext>;
+    projects?: readonly ExecutionProjectDefinition<TContext, TProjectContext>[];
     test?: TestOptions;
     output?: TestOutputDefinition;
     nodes?: readonly NodeDefinition<any, any, TContext>[];

package/dist/types/index.d.ts

@@ -129,7 +129,7 @@ export declare const createCaseRunner: <TContext = undefined>(options?: CaseRunn
 
 export declare const createDocumentRuntime: <TContext = undefined>(document: CollectedWorkflowDocument, options: CreateDocumentRuntimeOptions<TContext>) => WorkflowDocumentRuntime<TContext>;
 
-export declare type CreateDocumentRuntimeOptions<TContext = undefined> = Omit<Core.CreateDocumentRuntimeOptions<TContext>, 'documentSetup' | 'documentAttemptIndex' | 'resolveNode' | 'onStepResult' | 'onResult'> & {
+export declare type CreateDocumentRuntimeOptions<TContext = undefined> = Omit<Core.CreateDocumentRuntimeOptions<TContext>, 'documentSetup' | 'setupTimeoutMs' | 'teardownTimeoutMs' | 'documentAttemptIndex' | 'resolveNode' | 'onStepResult' | 'onResult'> & {
     resolveNode(name: string): NodeDefinition<any, any, TContext>;
     onStepResult?: StepResultHandler;
     onResult?(result: WorkflowDocumentRunResult): Core.Awaitable<unknown>;
@@ -262,7 +262,7 @@ export declare interface ResolveWorkflowVariablesOptions {
     location: VariableResolutionLocation;
 }
 
-export declare type RunCollectedCaseOptions<TContext = undefined> = Omit<Core.RunCollectedCaseOptions<TContext>, 'reportScopeId' | 'resolveNode' | 'beforeEach' | 'afterEach' | 'onStepResult' | 'onResult'> & {
+export declare type RunCollectedCaseOptions<TContext = undefined> = Omit<Core.RunCollectedCaseOptions<TContext>, 'reportScopeId' | 'teardownTimeoutMs' | 'resolveNode' | 'beforeEach' | 'afterEach' | 'onStepResult' | 'onResult'> & {
     resolveNode(name: string): NodeDefinition<any, any, TContext>;
     beforeEach?: readonly NormalizedStep[];
     afterEach?: readonly NormalizedStep[];
@@ -272,7 +272,7 @@ export declare type RunCollectedCaseOptions<TContext = undefined> = Omit<Core.Ru
 
 export declare const runWorkflowDocument: <TContext = undefined>(document: CollectedWorkflowDocument, options: RunWorkflowDocumentOptions<TContext>) => Promise<WorkflowDocumentExecutionResult>;
 
-export declare type RunWorkflowDocumentOptions<TContext = undefined> = Omit<Core.RunWorkflowDocumentOptions<TContext>, 'documentSetup' | 'documentAttemptIndex' | 'resolveCaseReportScopeId' | 'resolveNode' | 'onStepResult' | 'onCaseStart' | 'isFatalError' | 'onCaseResult' | 'onCaseOutcome' | 'onDocumentResult' | 'createCaseRunId' | 'createDocumentRunId'> & {
+export declare type RunWorkflowDocumentOptions<TContext = undefined> = Omit<Core.RunWorkflowDocumentOptions<TContext>, 'documentSetup' | 'setupTimeoutMs' | 'teardownTimeoutMs' | 'documentAttemptIndex' | 'resolveCaseReportScopeId' | 'resolveNode' | 'onStepResult' | 'onCaseStart' | 'isFatalError' | 'onCaseResult' | 'onCaseOutcome' | 'onDocumentResult' | 'createCaseRunId' | 'createDocumentRunId'> & {
     resolveNode(name: string): NodeDefinition<any, any, TContext>;
     onStepResult?: StepResultHandler;
     onCaseStart?(collectedCase: CollectedCase): Core.Awaitable<void>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@midscene/test",
   "description": "Midscene Test: an extensible YAML testing framework and Node SDK.",
-  "version": "1.15.6",
+  "version": "1.16.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -58,8 +58,8 @@
     "tsx": "^4.19.2",
     "yargs": "17.7.3",
     "zod": "^3.25.1",
-    "@midscene/core": "1.15.6",
-    "@midscene/shared": "1.15.6"
+    "@midscene/core": "1.16.1",
+    "@midscene/shared": "1.16.1"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",
@@ -71,20 +71,20 @@
     "puppeteer": "24.6.0",
     "typescript": "^5.8.3",
     "vitest": "3.0.5",
-    "@midscene/android": "1.15.6",
-    "@midscene/harmony": "1.15.6",
-    "@midscene/computer": "1.15.6",
-    "@midscene/ios": "1.15.6",
-    "@midscene/web": "1.15.6"
+    "@midscene/android": "1.16.1",
+    "@midscene/harmony": "1.16.1",
+    "@midscene/ios": "1.16.1",
+    "@midscene/computer": "1.16.1",
+    "@midscene/web": "1.16.1"
   },
   "peerDependencies": {
     "playwright": "^1.45.0",
     "puppeteer": "24.6.0",
-    "@midscene/android": "1.15.6",
-    "@midscene/harmony": "1.15.6",
-    "@midscene/computer": "1.15.6",
-    "@midscene/web": "1.15.6",
-    "@midscene/ios": "1.15.6"
+    "@midscene/computer": "1.16.1",
+    "@midscene/ios": "1.16.1",
+    "@midscene/android": "1.16.1",
+    "@midscene/harmony": "1.16.1",
+    "@midscene/web": "1.16.1"
   },
   "peerDependenciesMeta": {
     "@midscene/android": {