@hyperfrontend/project-scope 0.2.1 → 0.2.3

package/tech/types/index.d.ts

@@ -1,2 +1,120 @@
-export * from './detectors';
-//# sourceMappingURL=index.d.ts.map
+import { PackageJson } from '../../project/package';
+import { DetectionSource } from '..';
+
+/**
+ * Type system detection result.
+ */
+interface TypeSystemDetection {
+    /** Type system identifier */
+    id: 'typescript' | 'flow' | 'jsdoc';
+    /** Human-readable name */
+    name: string;
+    /** Detected version */
+    version?: string;
+    /** Config file path */
+    configPath?: string;
+    /** Strict mode enabled */
+    strictMode?: boolean;
+    /** Detection confidence (0-100) */
+    confidence: number;
+    /** Detection sources */
+    detectedFrom: DetectionSource[];
+}
+/**
+ * Type system detector interface.
+ */
+interface TypeSystemDetector {
+    /** Type system identifier */
+    id: 'typescript' | 'flow' | 'jsdoc';
+    /** Human-readable name */
+    name: string;
+    /** Check if type system is present */
+    detect(projectPath: string, packageJson?: PackageJson): TypeSystemDetection | null;
+}
+/**
+ * Detect TypeScript in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting TypeScript
+ * ```typescript
+ * import { typescriptDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = typescriptDetector('./my-project')
+ * if (result) {
+ *   console.log(`TypeScript ${result.version}`)
+ *   console.log(`Strict mode: ${result.strictMode ?? 'unknown'}`)
+ *   // => "TypeScript 5.3.0"
+ *   // => "Strict mode: true"
+ * }
+ * ```
+ */
+declare function typescriptDetector(projectPath: string, packageJson?: PackageJson): TypeSystemDetection | null;
+/**
+ * Detect Flow in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Flow type system
+ * ```typescript
+ * import { flowDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = flowDetector('./my-project')
+ * if (result) {
+ *   console.log(`Flow ${result.version} with config: ${result.configPath}`)
+ *   // => "Flow 0.232.0 with config: .flowconfig"
+ * }
+ * ```
+ */
+declare function flowDetector(projectPath: string, packageJson?: PackageJson): TypeSystemDetection | null;
+/**
+ * Detect JSDoc type annotations in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting JSDoc type annotations
+ * ```typescript
+ * import { jsdocDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = jsdocDetector('./my-project')
+ * if (result) {
+ *   console.log('JSDoc types detected')
+ *   console.log('Sources:', result.detectedFrom.map(s => s.path ?? s.field))
+ *   // => "Sources: ['jsconfig.json', 'src/utils.js (JSDoc annotations)']"
+ * }
+ * ```
+ */
+declare function jsdocDetector(projectPath: string, packageJson?: PackageJson): TypeSystemDetection | null;
+/** All type system detectors */
+declare const typeSystemDetectors: TypeSystemDetector[];
+/**
+ * Detect all type systems in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Array of detected type systems, sorted by confidence
+ *
+ * @example Detecting all type systems
+ * ```typescript
+ * import { detectTypeSystems } from '@hyperfrontend/project-scope'
+ *
+ * const typeSystems = detectTypeSystems('./my-project')
+ * // => [
+ * //   { id: 'typescript', name: 'TypeScript', version: '5.3.0', strictMode: true, confidence: 95, ... },
+ * //   { id: 'jsdoc', name: 'JSDoc', confidence: 40, ... }
+ * // ]
+ *
+ * const primary = typeSystems[0]?.name ?? 'None'
+ * console.log(`Primary type system: ${primary}`)
+ * ```
+ */
+declare function detectTypeSystems(projectPath: string, packageJson?: PackageJson): TypeSystemDetection[];
+
+export { detectTypeSystems, flowDetector, jsdocDetector, typeSystemDetectors, typescriptDetector };
+export type { TypeSystemDetection, TypeSystemDetector };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/project-scope/src/tech/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/project-scope/src/tech/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}