@testspectra/cli 1.1.8-rc.1 → 1.1.8-rc.11

package/dist/commands/add.js

@@ -289,6 +289,7 @@ export async function addCommand(moduleNameArg, options = {}) {
         copyRecursive(sampleE2eSrc, targetE2eDir, {
             'playground-e2e': e2eProjectName,
             'packages/playground/e2e': path.relative(rootDir, targetE2eDir).replace(/\\/g, '/'),
+            'testspectra:scope:playground': `testspectra:scope:${featureName}`,
             'scope:playground': `scope:${featureName}`,
         });
         // Adjust project.json
@@ -300,7 +301,7 @@ export async function addCommand(moduleNameArg, options = {}) {
                 pObj.sourceRoot = path.relative(rootDir, targetE2eDir).replace(/\\/g, '/');
                 pObj.targets.e2e.options.cwd = path.relative(rootDir, targetE2eDir).replace(/\\/g, '/');
                 pObj.targets['type-check'].options.cwd = '.';
-                pObj.tags = [`scope:${featureName}`, 'type:e2e'];
+                pObj.tags = ['testspectra:e2e', `testspectra:scope:${featureName}`];
                 fs.writeFileSync(projJsonPath, JSON.stringify(pObj, null, 2), 'utf-8');
             }
             catch { }

package/dist/commands/init.js

@@ -508,6 +508,7 @@ export async function initCommand(options = {}) {
             copyRecursive(sampleE2eSrc, targetE2eDir, {
                 'playground-e2e': e2eProjectName,
                 'packages/playground/e2e': path.relative(cwd, targetE2eDir).replace(/\\/g, '/'),
+                'testspectra:scope:playground': `testspectra:scope:${featureName}`,
                 'scope:playground': `scope:${featureName}`,
             });
             // Adjust project.json
@@ -519,7 +520,7 @@ export async function initCommand(options = {}) {
                     pObj.sourceRoot = path.relative(cwd, targetE2eDir).replace(/\\/g, '/');
                     pObj.targets.e2e.options.cwd = path.relative(cwd, targetE2eDir).replace(/\\/g, '/');
                     pObj.targets['type-check'].options.cwd = '.';
-                    pObj.tags = [`scope:${featureName}`, 'type:e2e'];
+                    pObj.tags = ['testspectra:e2e', `testspectra:scope:${featureName}`];
                     fs.writeFileSync(projJsonPath, JSON.stringify(pObj, null, 2), 'utf-8');
                 }
                 catch { }

package/dist/commands/test.js

@@ -1,6 +1,8 @@
 import path from 'node:path';
 import chalk from 'chalk';
 import * as p from '@clack/prompts';
+import { renderSummaryView } from '../reporter/summary-view.js';
+import { Reporter } from '../runner/reporter.js';
 import { runSystemChecks } from './doctor.js';
 /**
  * Finds the Chrome-for-Testing binary that `spectra doctor` already installs/manages for the
@@ -63,14 +65,40 @@ export async function testCommand(options = {}) {
         headless = options.headless;
     }
     const concurrency = options.concurrency !== undefined ? parseInt(String(options.concurrency), 10) : undefined;
+    const outputFile = options.output ? path.resolve(cwd, options.output) : undefined;
+    // Reuses the exact same semantic terminal reporter `spectra run` drives (see
+    // docs/v2/cli/matchers-semantic-reporter.md) — @testspectra/react emits the identical
+    // [TESTSPECTRA_*] protocol lines the E2E Rust orchestrator does (see tools/react/src/prelude.ts
+    // / setup.ts), so the same Reporter class parses them with zero changes on either side.
+    const reporter = new Reporter();
+    const runStartedAt = Date.now();
     const ok = await reactPkg.runComponentTests({
         cwd,
         headless,
         stepDelayMs,
         spec: options.spec,
-        outputFile: options.output ? path.resolve(cwd, options.output) : undefined,
+        outputFile,
         concurrency: concurrency !== undefined && !isNaN(concurrency) ? concurrency : undefined,
         browserExecutablePath,
+        onLine: (line) => {
+            if (!line.startsWith('[TESTSPECTRA_'))
+                return;
+            reporter.addLog({ timestamp: new Date().toLocaleTimeString(), level: 'INFO', message: line });
+            if (!reporter.isInteractiveMode()) {
+                console.log(line);
+            }
+        },
+    });
+    const durationMs = Date.now() - runStartedAt;
+    const result = reporter.generateResult(ok ? 'passed' : 'failed', `${(durationMs / 1000).toFixed(1)}s`);
+    const totalTests = result.passedCount + result.failedCount;
+    renderSummaryView({
+        totalSuites: totalTests,
+        totalTests,
+        passedCount: result.passedCount,
+        failedCount: result.failedCount,
+        durationMs,
+        reportLocation: outputFile ? path.relative(cwd, outputFile) : '(use -o/--output to save a report)',
     });
     process.exit(ok ? 0 : 1);
 }

package/dist/generator/__tests__/type-generator.test.js

@@ -383,4 +383,42 @@ async function verifyZeroImport() {
         expect(fs.existsSync(path.join(tmpDir, '.testspectra', 'types', 'web.d.ts'))).toBe(false);
         expect(fs.existsSync(path.join(tmpDir, '.testspectra', 'types', 'common.d.ts'))).toBe(false);
     });
+    it('nx monorepo: does NOT treat feature library as shared library and discovers nested e2e subproject', () => {
+        // 1. Shared library with testspectra:shared
+        const sharedDir = path.join(tmpDir, 'shared', 'testing');
+        fs.mkdirSync(path.join(sharedDir, 'page-objects', 'SharedNav'), { recursive: true });
+        fs.writeFileSync(path.join(sharedDir, 'project.json'), JSON.stringify({ name: 'shared-testing', projectType: 'library', tags: ['testspectra:shared'] }));
+        fs.writeFileSync(path.join(sharedDir, 'page-objects', 'SharedNav', 'common.ts'), 'export default class SharedNav {}');
+        // 2. Nx Feature library (projectType: "library", standard Nx tags, NO testspectra tags)
+        const featureLibDir = path.join(tmpDir, 'packages', 'features', 'auth');
+        fs.mkdirSync(featureLibDir, { recursive: true });
+        fs.writeFileSync(path.join(featureLibDir, 'project.json'), JSON.stringify({
+            name: '@tagsamurai/feature-auth',
+            projectType: 'library',
+            sourceRoot: 'packages/features/auth',
+            targets: {},
+            tags: ['type:feature', 'scope:feature-auth'],
+        }));
+        // 3. Nested E2E subproject inside feature library
+        const featureE2eDir = path.join(featureLibDir, 'e2e');
+        fs.mkdirSync(path.join(featureE2eDir, 'specs', 'AuthSuite', 'TC-001'), { recursive: true });
+        fs.writeFileSync(path.join(featureE2eDir, 'project.json'), JSON.stringify({
+            name: 'feature-auth-e2e',
+            projectType: 'application',
+            tags: ['testspectra:e2e', 'testspectra:scope:feature-auth'],
+        }));
+        fs.writeFileSync(path.join(featureE2eDir, 'specs', 'AuthSuite', 'TC-001', 'web.test.ts'), 'it("auth test", async () => {});');
+        const scopes = TypeGenerator.getEntityScopes(tmpDir);
+        expect(scopes).toHaveLength(2);
+        const sharedScope = scopes.find((s) => s.isShared);
+        expect(sharedScope).toBeDefined();
+        expect(sharedScope?.name).toBe('shared');
+        expect(sharedScope?.dir).toBe(path.resolve(sharedDir));
+        const featureScope = scopes.find((s) => !s.isShared);
+        expect(featureScope).toBeDefined();
+        expect(featureScope?.name).toBe('feature-auth');
+        expect(featureScope?.dir).toBe(path.resolve(featureE2eDir));
+        // Verify packages/features/auth is NOT in scopes
+        expect(scopes.some((s) => s.dir === path.resolve(featureLibDir))).toBe(false);
+    });
 });

package/dist/generator/type-generator.d.ts

@@ -9,8 +9,11 @@ export interface EntityScope {
  * Discovers all feature directories and shared library directories.
  * Standard discovery hierarchy:
  * 1. Nx / Monorepo Project Descriptors (`project.json`):
- *    - projectType: "library" OR tags: ["type:shared", "type:library", "scope:shared"] => Shared Library Scope (isShared: true)
- *    - projectType: "application" OR tags: ["type:e2e", "type:app"] => Feature Scope (isShared: false)
+ *    - tags: ["testspectra:shared"] => Shared Library Scope (isShared: true)
+ *    - tags: ["testspectra:e2e"] or ["testspectra:scope:<name>"] => Feature Scope (isShared: false)
+ *    - Generic Nx libraries/apps without testspectra tags are not TestSpectra scopes and recursion
+ *      continues into their subdirectories so nested e2e projects (e.g. `packages/features/auth/e2e`)
+ *      are discovered.
  * 2. Explicit User Configuration (`tsconfig.spectra.shared.json`):
  *    - Custom include path for shared testing utilities
  * 3. Dynamic Workspace Filesystem Discovery (Fallback for non-Nx / custom layouts):

package/dist/generator/type-generator.js

@@ -13,8 +13,11 @@ export const PLATFORM_HIERARCHY = {
  * Discovers all feature directories and shared library directories.
  * Standard discovery hierarchy:
  * 1. Nx / Monorepo Project Descriptors (`project.json`):
- *    - projectType: "library" OR tags: ["type:shared", "type:library", "scope:shared"] => Shared Library Scope (isShared: true)
- *    - projectType: "application" OR tags: ["type:e2e", "type:app"] => Feature Scope (isShared: false)
+ *    - tags: ["testspectra:shared"] => Shared Library Scope (isShared: true)
+ *    - tags: ["testspectra:e2e"] or ["testspectra:scope:<name>"] => Feature Scope (isShared: false)
+ *    - Generic Nx libraries/apps without testspectra tags are not TestSpectra scopes and recursion
+ *      continues into their subdirectories so nested e2e projects (e.g. `packages/features/auth/e2e`)
+ *      are discovered.
  * 2. Explicit User Configuration (`tsconfig.spectra.shared.json`):
  *    - Custom include path for shared testing utilities
  * 3. Dynamic Workspace Filesystem Discovery (Fallback for non-Nx / custom layouts):
@@ -48,16 +51,9 @@ export function discoverEntityScopes(cwd) {
         if (fs.existsSync(projectJsonPath)) {
             try {
                 const pObj = JSON.parse(fs.readFileSync(projectJsonPath, 'utf-8'));
-                const projectType = pObj.projectType;
                 const tags = Array.isArray(pObj.tags) ? pObj.tags : [];
-                const isSharedLib = projectType === 'library' ||
-                    tags.includes('type:shared') ||
-                    tags.includes('type:library') ||
-                    tags.includes('scope:shared');
-                const isE2eApp = projectType === 'application' ||
-                    tags.includes('type:e2e') ||
-                    tags.includes('type:app') ||
-                    tags.some((t) => t.startsWith('scope:') && t !== 'scope:shared');
+                const isSharedLib = tags.includes('testspectra:shared');
+                const isE2eApp = tags.includes('testspectra:e2e') || tags.some((t) => t.startsWith('testspectra:scope:'));
                 if (isSharedLib) {
                     if (!scopes.some((s) => s.dir === dir)) {
                         scopes.push({ name: 'shared', dir, isShared: true });
@@ -65,9 +61,9 @@ export function discoverEntityScopes(cwd) {
                     return; // Do not recurse into subdirectories of an identified project
                 }
                 else if (isE2eApp) {
-                    // Extract scope name from tags (e.g. "scope:matchers" => "matchers") or project name
-                    const scopeTag = tags.find((t) => t.startsWith('scope:') && t !== 'scope:shared');
-                    let featureName = scopeTag ? scopeTag.replace('scope:', '') : '';
+                    // Extract scope name from tags (e.g. "testspectra:scope:matchers" => "matchers") or project name
+                    const scopeTag = tags.find((t) => t.startsWith('testspectra:scope:'));
+                    let featureName = scopeTag ? scopeTag.replace('testspectra:scope:', '') : '';
                     if (!featureName && pObj.name) {
                         featureName = pObj.name.replace(/-e2e$/, '').replace(/^e2e-/, '');
                     }
@@ -329,6 +325,9 @@ export class TypeGenerator {
             const hierarchy = PLATFORM_HIERARCHY[platform];
             let content = `// Auto-generated ambient declarations for TestSpectra [${platform.toUpperCase()}]\n`;
             content += `// Managed automatically by TestSpectra Language Service Plugin.\n\n`;
+            content += `/// <reference types="@testspectra/matchers" />\n`;
+            content += `/// <reference path="./fixtures.d.ts" />\n`;
+            content += `/// <reference path="${envRefPath}" />\n\n`;
             // TestSpectra's Rust-native orchestrator worker (core/orchestrator/src/worker/bdd_runner.ts)
             // registers its own `it`/`test`/lifecycle-hook globals directly — there is no WDIO or Mocha
             // runtime involved at all (not just for component testing; this is true across every
@@ -346,9 +345,7 @@ export class TypeGenerator {
                 // — the Rust orchestrator's BDD runtime has no `expect` global at all.
                 content += `declare const expect: import('@testspectra/react').ExpectStatic;\n`;
             }
-            content += `/// <reference types="@testspectra/matchers" />\n`;
-            content += `/// <reference path="./fixtures.d.ts" />\n`;
-            content += `/// <reference path="${envRefPath}" />\n\n`;
+            content += `\n`;
             // 1. Page Objects Global Declarations
             const declaredPOMs = new Set();
             for (const poDir of poDirs) {

package/dist/linter/__tests__/shared-lib-boundary.test.js

@@ -17,16 +17,16 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
         }
     });
     describe('findSharedLibraryRoots()', () => {
-        it('discovers parent folders of project.json files containing both scope:shared and type:shared', () => {
+        it('discovers parent folders of project.json files containing testspectra:shared', () => {
             const sharedDir1 = path.join(tempDir, 'shared', 'testing');
             const sharedDir2 = path.join(tempDir, 'libs', 'common-helpers');
             const nonSharedDir = path.join(tempDir, 'packages', 'playground', 'e2e');
             fs.mkdirSync(sharedDir1, { recursive: true });
             fs.mkdirSync(sharedDir2, { recursive: true });
             fs.mkdirSync(nonSharedDir, { recursive: true });
-            fs.writeFileSync(path.join(sharedDir1, 'project.json'), JSON.stringify({ name: 'shared-testing', tags: ['scope:shared', 'type:shared'] }));
-            fs.writeFileSync(path.join(sharedDir2, 'project.json'), JSON.stringify({ name: 'common-helpers', tags: ['scope:shared', 'type:shared'] }));
-            fs.writeFileSync(path.join(nonSharedDir, 'project.json'), JSON.stringify({ name: 'playground-e2e', tags: ['scope:playground', 'type:e2e'] }));
+            fs.writeFileSync(path.join(sharedDir1, 'project.json'), JSON.stringify({ name: 'shared-testing', tags: ['testspectra:shared'] }));
+            fs.writeFileSync(path.join(sharedDir2, 'project.json'), JSON.stringify({ name: 'common-helpers', tags: ['testspectra:shared'] }));
+            fs.writeFileSync(path.join(nonSharedDir, 'project.json'), JSON.stringify({ name: 'playground-e2e', tags: ['testspectra:e2e', 'testspectra:scope:playground'] }));
             const roots = findSharedLibraryRoots(tempDir);
             expect(roots).toHaveLength(2);
             expect(roots).toContain(sharedDir1);
@@ -35,12 +35,12 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
         });
     });
     describe('isInsideSharedLibrary()', () => {
-        it('returns true for files inside a project tagged with scope:shared or type:shared in project.json', () => {
+        it('returns true for files inside a project tagged with testspectra:shared in project.json', () => {
             const sharedDir = path.join(tempDir, 'shared', 'testing');
             fs.mkdirSync(sharedDir, { recursive: true });
             fs.writeFileSync(path.join(sharedDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const stepFile = path.join(sharedDir, 'support', 'steps', 'web.step.ts');
             const specFile = path.join(sharedDir, 'specs', 'TC-001', 'spec.md');
@@ -55,7 +55,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(customLibDir, { recursive: true });
             fs.writeFileSync(path.join(customLibDir, 'project.json'), JSON.stringify({
                 name: 'custom-common-lib',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const actionFile = path.join(customLibDir, 'support', 'actions', 'click.action.ts');
             expect(isInsideSharedLibrary(actionFile)).toBe(true);
@@ -65,7 +65,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(sharedAppDir, { recursive: true });
             fs.writeFileSync(path.join(sharedAppDir, 'project.json'), JSON.stringify({
                 name: 'shared-app',
-                tags: ['scope:shared-app', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:shared-app'],
             }));
             const specFile = path.join(sharedAppDir, 'specs', 'TC-001', 'spec.md');
             expect(isInsideSharedLibrary(specFile)).toBe(false);
@@ -75,7 +75,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(featureDir, { recursive: true });
             fs.writeFileSync(path.join(featureDir, 'project.json'), JSON.stringify({
                 name: 'playground-e2e',
-                tags: ['scope:playground', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:playground'],
             }));
             const specFile = path.join(featureDir, 'specs', 'TC-001', 'spec.md');
             expect(isInsideSharedLibrary(specFile)).toBe(false);
@@ -91,7 +91,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(sharedLibDir, { recursive: true });
             fs.writeFileSync(path.join(sharedLibDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const sharedSpecDir = path.join(sharedLibDir, 'specs', 'TC-error');
             fs.mkdirSync(sharedSpecDir, { recursive: true });
@@ -119,7 +119,7 @@ status: draft
             fs.mkdirSync(sharedLibDir, { recursive: true });
             fs.writeFileSync(path.join(sharedLibDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const sharedSuiteDir = path.join(sharedLibDir, 'support');
             fs.mkdirSync(sharedSuiteDir, { recursive: true });
@@ -141,7 +141,7 @@ status: active
             fs.mkdirSync(customLibDir, { recursive: true });
             fs.writeFileSync(path.join(customLibDir, 'project.json'), JSON.stringify({
                 name: 'my-testing-utils',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const specDir = path.join(customLibDir, 'specs', 'TC-custom');
             fs.mkdirSync(specDir, { recursive: true });
@@ -169,7 +169,7 @@ status: draft
             fs.mkdirSync(featureDir, { recursive: true });
             fs.writeFileSync(path.join(featureDir, 'project.json'), JSON.stringify({
                 name: 'playground-e2e',
-                tags: ['scope:playground', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:playground'],
             }));
             const featureSpecDir = path.join(featureDir, 'specs', 'TC-001');
             fs.mkdirSync(featureSpecDir, { recursive: true });
@@ -195,7 +195,7 @@ status: draft
             fs.mkdirSync(sharedE2eDir, { recursive: true });
             fs.writeFileSync(path.join(sharedE2eDir, 'project.json'), JSON.stringify({
                 name: 'shared-feature-e2e',
-                tags: ['scope:shared-feature', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:shared-feature'],
             }));
             const specDir = path.join(sharedE2eDir, 'specs', 'TC-001');
             fs.mkdirSync(specDir, { recursive: true });
@@ -241,7 +241,7 @@ status: draft
             fs.mkdirSync(sharedLibDir, { recursive: true });
             fs.writeFileSync(path.join(sharedLibDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const sharedDir1 = path.join(sharedLibDir, 'specs', 'TC-001');
             const sharedDir2 = path.join(sharedLibDir, 'specs', 'TC-002');

package/dist/linter/discovery.d.ts

@@ -4,14 +4,14 @@ export interface WorkspaceAssets {
     fixtures: Set<string>;
 }
 /**
- * Scans a workspace directory for all `project.json` files that have both
- * "scope:shared" and "type:shared" tags, and returns their parent folder paths.
+ * Scans a workspace directory for all `project.json` files that have the
+ * "testspectra:shared" tag, and returns their parent folder paths.
  */
 export declare function findSharedLibraryRoots(workspaceDir: string): string[];
 /**
  * Resolves the root directory of a shared testing library if the file path is inside one.
  * Determines shared library status based on `project.json` containing
- * both "scope:shared" and "type:shared" tags in ancestor directories,
+ * the "testspectra:shared" tag in ancestor directories,
  * taking the parent folder of that `project.json` as the shared library root.
  */
 export declare function getSharedLibraryRoot(filePath: string, workspaceDir?: string): string | null;

package/dist/linter/discovery.js

@@ -1,8 +1,8 @@
 import fs from 'fs';
 import path from 'path';
 /**
- * Scans a workspace directory for all `project.json` files that have both
- * "scope:shared" and "type:shared" tags, and returns their parent folder paths.
+ * Scans a workspace directory for all `project.json` files that have the
+ * "testspectra:shared" tag, and returns their parent folder paths.
  */
 export function findSharedLibraryRoots(workspaceDir) {
     const sharedRoots = [];
@@ -23,7 +23,7 @@ export function findSharedLibraryRoots(workspaceDir) {
                         const raw = fs.readFileSync(path.join(dir, entry.name), 'utf-8');
                         const parsed = JSON.parse(raw);
                         const tags = Array.isArray(parsed.tags) ? parsed.tags : [];
-                        if (tags.includes('scope:shared') && tags.includes('type:shared')) {
+                        if (tags.includes('testspectra:shared')) {
                             sharedRoots.push(dir);
                         }
                     }
@@ -39,7 +39,7 @@ export function findSharedLibraryRoots(workspaceDir) {
 /**
  * Resolves the root directory of a shared testing library if the file path is inside one.
  * Determines shared library status based on `project.json` containing
- * both "scope:shared" and "type:shared" tags in ancestor directories,
+ * the "testspectra:shared" tag in ancestor directories,
  * taking the parent folder of that `project.json` as the shared library root.
  */
 export function getSharedLibraryRoot(filePath, workspaceDir) {
@@ -67,7 +67,7 @@ export function getSharedLibraryRoot(filePath, workspaceDir) {
                 const raw = fs.readFileSync(projectJsonPath, 'utf-8');
                 const projectConfig = JSON.parse(raw);
                 const tags = Array.isArray(projectConfig.tags) ? projectConfig.tags : [];
-                if (tags.includes('scope:shared') && tags.includes('type:shared')) {
+                if (tags.includes('testspectra:shared')) {
                     return current;
                 }
                 return null;

package/dist/linter/schemas/spec.schema.d.ts

@@ -11,11 +11,11 @@ export declare const CoverageSchema: z.ZodObject<{
     web: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
     mobile: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
 }, "strip", z.ZodTypeAny, {
-    mobile?: "automated" | "manual" | "unsupported" | undefined;
     web?: "automated" | "manual" | "unsupported" | undefined;
-}, {
     mobile?: "automated" | "manual" | "unsupported" | undefined;
+}, {
     web?: "automated" | "manual" | "unsupported" | undefined;
+    mobile?: "automated" | "manual" | "unsupported" | undefined;
 }>;
 export declare const SpecFrontmatterSchema: z.ZodObject<{
     id: z.ZodString;
@@ -27,33 +27,33 @@ export declare const SpecFrontmatterSchema: z.ZodObject<{
         web: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
         mobile: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
     }, "strip", z.ZodTypeAny, {
-        mobile?: "automated" | "manual" | "unsupported" | undefined;
         web?: "automated" | "manual" | "unsupported" | undefined;
-    }, {
         mobile?: "automated" | "manual" | "unsupported" | undefined;
+    }, {
         web?: "automated" | "manual" | "unsupported" | undefined;
+        mobile?: "automated" | "manual" | "unsupported" | undefined;
     }>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
-    title: string;
     id: string;
+    title: string;
+    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
     priority: "Critical" | "High" | "Medium" | "Low";
     caseType: "Positive" | "Negative" | "Edge";
     coverage?: {
-        mobile?: "automated" | "manual" | "unsupported" | undefined;
         web?: "automated" | "manual" | "unsupported" | undefined;
+        mobile?: "automated" | "manual" | "unsupported" | undefined;
     } | undefined;
     tags?: string[] | undefined;
 }, {
-    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
-    title: string;
     id: string;
+    title: string;
+    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
     priority: "Critical" | "High" | "Medium" | "Low";
     caseType: "Positive" | "Negative" | "Edge";
     coverage?: {
-        mobile?: "automated" | "manual" | "unsupported" | undefined;
         web?: "automated" | "manual" | "unsupported" | undefined;
+        mobile?: "automated" | "manual" | "unsupported" | undefined;
     } | undefined;
     tags?: string[] | undefined;
 }>;

package/dist/linter/schemas/suite.schema.d.ts

@@ -14,36 +14,36 @@ export declare const SuiteFrontmatterSchema: z.ZodEffects<z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    status?: "active" | "draft" | "deprecated" | undefined;
-    title?: string | undefined;
     name?: string | undefined;
+    title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | undefined;
     parallel?: boolean | undefined;
 }, {
     id: string;
-    status?: "active" | "draft" | "deprecated" | undefined;
-    title?: string | undefined;
     name?: string | undefined;
+    title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | undefined;
     parallel?: boolean | undefined;
 }>, {
     id: string;
-    status?: "active" | "draft" | "deprecated" | undefined;
-    title?: string | undefined;
     name?: string | undefined;
+    title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | undefined;
     parallel?: boolean | undefined;
 }, {
     id: string;
-    status?: "active" | "draft" | "deprecated" | undefined;
-    title?: string | undefined;
     name?: string | undefined;
+    title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | undefined;

package/dist/reporter/semantic-formatter.js

@@ -50,6 +50,11 @@ function formatCollectionTarget(target) {
 export function formatAction(actionKey, target, args = {}) {
     const el = formatElementTarget(target);
     switch (actionKey) {
+        // Component testing only (@testspectra/react's Spectra.mount()) — target is a component name,
+        // not a DOM selector, so it's rendered plainly rather than through formatElementTarget's
+        // `element "..."` wrapping.
+        case 'mount':
+            return `Mount component "${extractTargetString(target) || '{component}'}"`;
         case 'click':
             return `Click on ${el}`;
         case 'doubleClick':

package/dist/runner/bridge.js

@@ -1,15 +1,60 @@
 import { spawn } from 'child_process';
 import fs from 'fs';
 import path from 'path';
+import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const require = createRequire(import.meta.url);
+// Maps process.platform/process.arch to the optionalDependency package that carries the
+// prebuilt native binary for that platform (see cli/npm/*). Keep in sync with the
+// optionalDependencies list in cli/package.json and the packages built by
+// scripts/release-cli-local.sh.
+function platformPackageName() {
+    const { platform, arch } = process;
+    if (platform === 'darwin' && arch === 'arm64')
+        return '@testspectra/cli-darwin-arm64';
+    if (platform === 'linux' && arch === 'x64')
+        return '@testspectra/cli-linux-x64';
+    if (platform === 'win32' && arch === 'arm64')
+        return '@testspectra/cli-win32-arm64';
+    if (platform === 'win32' && arch === 'x64')
+        return '@testspectra/cli-win32-x64';
+    return null;
+}
 export class RustCoreBridge {
     static resolveBinaryPath() {
-        // 1. Look for precompiled release/debug binary in workspace target
-        const workspaceRoot = path.resolve(__dirname, '../../..');
         const isWindows = process.platform === 'win32';
         const binaryName = isWindows ? 'testspectra-runner.exe' : 'testspectra-runner';
+        // 1. Production install: resolve the prebuilt binary from the platform-specific
+        // optionalDependency package (e.g. @testspectra/cli-darwin-arm64). This is how the
+        // published npm package ships native binaries for every supported platform without
+        // bundling all of them into @testspectra/cli itself.
+        const pkgName = platformPackageName();
+        if (pkgName) {
+            try {
+                const pkgJsonPath = require.resolve(`${pkgName}/package.json`);
+                const pkgBinPath = path.join(path.dirname(pkgJsonPath), 'bin', binaryName);
+                if (fs.existsSync(pkgBinPath)) {
+                    if (process.platform !== 'win32') {
+                        try {
+                            const stat = fs.statSync(pkgBinPath);
+                            if ((stat.mode & 0o111) === 0) {
+                                fs.chmodSync(pkgBinPath, 0o755);
+                            }
+                        }
+                        catch { }
+                    }
+                    return pkgBinPath;
+                }
+            }
+            catch {
+                // Optional dependency not installed — fall through to the workspace dev paths below.
+            }
+        }
+        // 2. Monorepo dev fallback: look for a precompiled release/debug binary in the workspace
+        // target, as produced by scripts/ensure-runner-binary.js during local development.
+        const workspaceRoot = path.resolve(__dirname, '../../..');
         const candidatePaths = [
             path.join(workspaceRoot, 'core/target/release', binaryName),
             path.join(workspaceRoot, 'target/release', binaryName),
@@ -29,8 +74,11 @@ export class RustCoreBridge {
                 return `${p}.exe`;
             }
         }
-        throw new Error("[TestSpectra] Native core runner binary 'testspectra-runner' not found.\n" +
-            "Please build the project first using 'pnpm run build' or 'pnpm run build:core'.");
+        throw new Error(pkgName
+            ? `[TestSpectra] Native core runner binary not found for ${process.platform}/${process.arch}.\n` +
+                `Expected the optional dependency '${pkgName}' to provide it. Try reinstalling ` +
+                "('npm install' / 'pnpm install') without --no-optional, or build locally with 'pnpm run build:core'."
+            : `[TestSpectra] ${process.platform}/${process.arch} is not currently supported by @testspectra/cli.`);
     }
     static async run(options, reporter) {
         const binPath = this.resolveBinaryPath();