@hyperfrontend/project-scope 0.2.0 → 0.2.2

package/tech/testing/index.d.ts

@@ -1,8 +1,176 @@
-export * from './types';
-export * from './jest';
-export * from './vitest';
-export * from './mocha';
-export * from './cypress';
-export * from './playwright';
-export * from './detect-all';
-//# sourceMappingURL=index.d.ts.map
+import { PackageJson } from '../../project/package';
+import { DetectionSource } from '..';
+
+/**
+ * Testing framework detection result.
+ */
+interface TestingFrameworkDetection {
+    /** Framework identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detected version */
+    version?: string;
+    /** Config file path */
+    configPath?: string;
+    /** Test type */
+    type: 'unit' | 'e2e' | 'integration';
+    /** Detection confidence (0-100) */
+    confidence: number;
+    /** Detection sources */
+    detectedFrom: DetectionSource[];
+}
+/**
+ * Testing framework detector interface.
+ */
+interface TestingFrameworkDetector {
+    /** Framework identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Test type */
+    testType: 'unit' | 'e2e' | 'integration';
+    /** Check if framework is present */
+    detect(projectPath: string, packageJson?: PackageJson): TestingFrameworkDetection | null;
+}
+
+/** Config patterns for Cypress */
+declare const CYPRESS_CONFIG_PATTERNS: string[];
+/**
+ * Detect Cypress in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Cypress testing framework
+ * ```typescript
+ * import { cypressDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = cypressDetector('./my-project')
+ * if (result) {
+ *   console.log(`Cypress ${result.version} detected (${result.confidence}% confidence)`)
+ *   // => "Cypress 13.6.0 detected (95% confidence)"
+ * }
+ * ```
+ */
+declare function cypressDetector(projectPath: string, packageJson?: PackageJson): TestingFrameworkDetection | null;
+
+/** All testing framework detectors */
+declare const testingDetectors: TestingFrameworkDetector[];
+/**
+ * Detect all testing frameworks in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Array of detected testing frameworks, sorted by confidence
+ *
+ * @example Detecting multiple testing frameworks
+ * ```typescript
+ * import { detectTestingFrameworks } from '@hyperfrontend/project-scope'
+ *
+ * const frameworks = detectTestingFrameworks('./my-project')
+ * // => [
+ * //   { id: 'jest', name: 'Jest', type: 'unit', confidence: 95, ... },
+ * //   { id: 'cypress', name: 'Cypress', type: 'e2e', confidence: 85, ... }
+ * // ]
+ *
+ * // Results are sorted by confidence (highest first)
+ * const primary = frameworks[0]?.name ?? 'None'
+ * console.log(`Primary testing framework: ${primary}`)
+ * ```
+ */
+declare function detectTestingFrameworks(projectPath: string, packageJson?: PackageJson): TestingFrameworkDetection[];
+
+/** Config patterns for Jest */
+declare const JEST_CONFIG_PATTERNS: string[];
+/**
+ * Detect Jest in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Jest testing framework
+ * ```typescript
+ * import { jestDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = jestDetector('./my-project')
+ * if (result) {
+ *   console.log(`Jest ${result.version} detected`)
+ *   console.log('Sources:', result.detectedFrom.map(s => s.type))
+ *   // => "Sources: ['package.json', 'config-file']"
+ * }
+ * ```
+ */
+declare function jestDetector(projectPath: string, packageJson?: PackageJson): TestingFrameworkDetection | null;
+
+/** Config patterns for Mocha */
+declare const MOCHA_CONFIG_PATTERNS: string[];
+/**
+ * Detect Mocha in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Mocha testing framework
+ * ```typescript
+ * import { mochaDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = mochaDetector('./my-project')
+ * if (result) {
+ *   console.log(`Mocha ${result.version} detected (${result.confidence}%)`)
+ *   // => "Mocha 10.2.0 detected (95%)"
+ * }
+ * ```
+ */
+declare function mochaDetector(projectPath: string, packageJson?: PackageJson): TestingFrameworkDetection | null;
+
+/** Config patterns for Playwright */
+declare const PLAYWRIGHT_CONFIG_PATTERNS: string[];
+/**
+ * Detect Playwright in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Playwright testing framework
+ * ```typescript
+ * import { playwrightDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = playwrightDetector('./my-project')
+ * if (result) {
+ *   console.log(`Playwright ${result.version} (${result.type} tests)`)
+ *   // => "Playwright 1.42.0 (e2e tests)"
+ * }
+ * ```
+ */
+declare function playwrightDetector(projectPath: string, packageJson?: PackageJson): TestingFrameworkDetection | null;
+
+/** Config patterns for Vitest */
+declare const VITEST_CONFIG_PATTERNS: string[];
+/**
+ * Detect Vitest in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Vitest testing framework
+ * ```typescript
+ * import { vitestDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = vitestDetector('./my-project')
+ * if (result) {
+ *   console.log(`Vitest ${result.version} detected`)
+ *   console.log('Config:', result.configPath)
+ *   // => "Config: vitest.config.ts"
+ * }
+ * ```
+ */
+declare function vitestDetector(projectPath: string, packageJson?: PackageJson): TestingFrameworkDetection | null;
+
+export { CYPRESS_CONFIG_PATTERNS, JEST_CONFIG_PATTERNS, MOCHA_CONFIG_PATTERNS, PLAYWRIGHT_CONFIG_PATTERNS, VITEST_CONFIG_PATTERNS, cypressDetector, detectTestingFrameworks, jestDetector, mochaDetector, playwrightDetector, testingDetectors, vitestDetector };
+export type { TestingFrameworkDetection, TestingFrameworkDetector };

package/tech/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/project-scope/src/tech/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/project-scope/src/tech/testing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAC3D,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC7E,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}