@timmeck/brain 1.0.0 → 1.1.1

package/src/code/parsers/typescript.ts

@@ -1,65 +1,65 @@
-import type { ExportInfo } from '../../types/code.types.js';
-
-const NAMED_EXPORT_RE = /export\s+(?:async\s+)?(?:function|const|let|var|class|interface|type|enum)\s+(\w+)/g;
-const DEFAULT_EXPORT_RE = /export\s+default\s+(?:(?:async\s+)?(?:function|class)\s+)?(\w+)?/g;
-const IMPORT_RE = /import\s+(?:(?:type\s+)?(?:\{[^}]*\}|\*\s+as\s+\w+|\w+)(?:\s*,\s*(?:\{[^}]*\}|\*\s+as\s+\w+|\w+))*\s+from\s+)?['"]([^'"]+)['"]/g;
-
-export function extractExports(source: string): ExportInfo[] {
-  const exports: ExportInfo[] = [];
-  let match: RegExpExecArray | null;
-
-  const namedRe = new RegExp(NAMED_EXPORT_RE.source, 'g');
-  while ((match = namedRe.exec(source)) !== null) {
-    const line = source.substring(
-      source.lastIndexOf('\n', match.index) + 1,
-      source.indexOf('\n', match.index),
-    );
-    exports.push({
-      name: match[1]!,
-      type: detectExportType(line),
-    });
-  }
-
-  const defaultRe = new RegExp(DEFAULT_EXPORT_RE.source, 'g');
-  while ((match = defaultRe.exec(source)) !== null) {
-    exports.push({
-      name: match[1] ?? 'default',
-      type: 'function',
-    });
-  }
-
-  return exports;
-}
-
-export function extractImports(source: string): { external: string[]; internal: string[] } {
-  const external: string[] = [];
-  const internal: string[] = [];
-  let match: RegExpExecArray | null;
-
-  const importRe = new RegExp(IMPORT_RE.source, 'g');
-  while ((match = importRe.exec(source)) !== null) {
-    const specifier = match[1]!;
-    if (specifier.startsWith('.') || specifier.startsWith('/')) {
-      internal.push(specifier);
-    } else {
-      external.push(specifier);
-    }
-  }
-
-  return { external, internal };
-}
-
-export function hasTypeAnnotations(source: string): boolean {
-  return /:\s*\w+[\[\]<>|&]*\s*[=;,)\n{]/.test(source) ||
-    /interface\s+\w+/.test(source) ||
-    /type\s+\w+\s*=/.test(source);
-}
-
-function detectExportType(line: string): ExportInfo['type'] {
-  if (/\bfunction\b/.test(line)) return 'function';
-  if (/\bclass\b/.test(line)) return 'class';
-  if (/\binterface\b/.test(line)) return 'interface';
-  if (/\btype\b/.test(line)) return 'type';
-  if (/\bconst\b/.test(line)) return 'constant';
-  return 'variable';
-}
+import type { ExportInfo } from '../../types/code.types.js';
+
+const NAMED_EXPORT_RE = /export\s+(?:async\s+)?(?:function|const|let|var|class|interface|type|enum)\s+(\w+)/g;
+const DEFAULT_EXPORT_RE = /export\s+default\s+(?:(?:async\s+)?(?:function|class)\s+)?(\w+)?/g;
+const IMPORT_RE = /import\s+(?:(?:type\s+)?(?:\{[^}]*\}|\*\s+as\s+\w+|\w+)(?:\s*,\s*(?:\{[^}]*\}|\*\s+as\s+\w+|\w+))*\s+from\s+)?['"]([^'"]+)['"]/g;
+
+export function extractExports(source: string): ExportInfo[] {
+  const exports: ExportInfo[] = [];
+  let match: RegExpExecArray | null;
+
+  const namedRe = new RegExp(NAMED_EXPORT_RE.source, 'g');
+  while ((match = namedRe.exec(source)) !== null) {
+    const line = source.substring(
+      source.lastIndexOf('\n', match.index) + 1,
+      source.indexOf('\n', match.index),
+    );
+    exports.push({
+      name: match[1]!,
+      type: detectExportType(line),
+    });
+  }
+
+  const defaultRe = new RegExp(DEFAULT_EXPORT_RE.source, 'g');
+  while ((match = defaultRe.exec(source)) !== null) {
+    exports.push({
+      name: match[1] ?? 'default',
+      type: 'function',
+    });
+  }
+
+  return exports;
+}
+
+export function extractImports(source: string): { external: string[]; internal: string[] } {
+  const external: string[] = [];
+  const internal: string[] = [];
+  let match: RegExpExecArray | null;
+
+  const importRe = new RegExp(IMPORT_RE.source, 'g');
+  while ((match = importRe.exec(source)) !== null) {
+    const specifier = match[1]!;
+    if (specifier.startsWith('.') || specifier.startsWith('/')) {
+      internal.push(specifier);
+    } else {
+      external.push(specifier);
+    }
+  }
+
+  return { external, internal };
+}
+
+export function hasTypeAnnotations(source: string): boolean {
+  return /:\s*\w+[\[\]<>|&]*\s*[=;,)\n{]/.test(source) ||
+    /interface\s+\w+/.test(source) ||
+    /type\s+\w+\s*=/.test(source);
+}
+
+function detectExportType(line: string): ExportInfo['type'] {
+  if (/\bfunction\b/.test(line)) return 'function';
+  if (/\bclass\b/.test(line)) return 'class';
+  if (/\binterface\b/.test(line)) return 'interface';
+  if (/\btype\b/.test(line)) return 'type';
+  if (/\bconst\b/.test(line)) return 'constant';
+  return 'variable';
+}

package/src/code/registry.ts

@@ -1,60 +1,60 @@
-import type { ExportInfo } from '../types/code.types.js';
-import { analyzeCode, measureCohesion } from './analyzer.js';
-
-export type ModuleType = 'file' | 'class' | 'function';
-
-export function detectGranularity(
-  source: string,
-  language: string,
-): ModuleType {
-  const { exports } = analyzeCode(source, language);
-
-  const hasDefault = exports.some(e => e.name === 'default');
-  if (hasDefault && exports.length <= 3) return 'file';
-
-  const classes = exports.filter(e => e.type === 'class');
-  if (classes.length === 1 && exports.length <= 3) return 'class';
-
-  if (exports.length > 3) {
-    const cohesion = measureCohesion(exports);
-    if (cohesion < 0.5) return 'function';
-  }
-
-  return 'file';
-}
-
-export interface ModuleRegistration {
-  name: string;
-  filePath: string;
-  language: string;
-  source: string;
-  description?: string;
-  projectId: number;
-}
-
-export interface RegisteredModule {
-  name: string;
-  moduleType: ModuleType;
-  exports: ExportInfo[];
-  externalDeps: string[];
-  internalDeps: string[];
-  isPure: boolean;
-  hasTypeAnnotations: boolean;
-  linesOfCode: number;
-}
-
-export function prepareModule(reg: ModuleRegistration): RegisteredModule {
-  const analysis = analyzeCode(reg.source, reg.language);
-  const moduleType = detectGranularity(reg.source, reg.language);
-
-  return {
-    name: reg.name,
-    moduleType,
-    exports: analysis.exports,
-    externalDeps: analysis.externalDeps,
-    internalDeps: analysis.internalDeps,
-    isPure: analysis.isPure,
-    hasTypeAnnotations: analysis.hasTypeAnnotations,
-    linesOfCode: analysis.linesOfCode,
-  };
-}
+import type { ExportInfo } from '../types/code.types.js';
+import { analyzeCode, measureCohesion } from './analyzer.js';
+
+export type ModuleType = 'file' | 'class' | 'function';
+
+export function detectGranularity(
+  source: string,
+  language: string,
+): ModuleType {
+  const { exports } = analyzeCode(source, language);
+
+  const hasDefault = exports.some(e => e.name === 'default');
+  if (hasDefault && exports.length <= 3) return 'file';
+
+  const classes = exports.filter(e => e.type === 'class');
+  if (classes.length === 1 && exports.length <= 3) return 'class';
+
+  if (exports.length > 3) {
+    const cohesion = measureCohesion(exports);
+    if (cohesion < 0.5) return 'function';
+  }
+
+  return 'file';
+}
+
+export interface ModuleRegistration {
+  name: string;
+  filePath: string;
+  language: string;
+  source: string;
+  description?: string;
+  projectId: number;
+}
+
+export interface RegisteredModule {
+  name: string;
+  moduleType: ModuleType;
+  exports: ExportInfo[];
+  externalDeps: string[];
+  internalDeps: string[];
+  isPure: boolean;
+  hasTypeAnnotations: boolean;
+  linesOfCode: number;
+}
+
+export function prepareModule(reg: ModuleRegistration): RegisteredModule {
+  const analysis = analyzeCode(reg.source, reg.language);
+  const moduleType = detectGranularity(reg.source, reg.language);
+
+  return {
+    name: reg.name,
+    moduleType,
+    exports: analysis.exports,
+    externalDeps: analysis.externalDeps,
+    internalDeps: analysis.internalDeps,
+    isPure: analysis.isPure,
+    hasTypeAnnotations: analysis.hasTypeAnnotations,
+    linesOfCode: analysis.linesOfCode,
+  };
+}

package/src/code/scorer.ts

@@ -1,108 +1,108 @@
-import type { ExportInfo } from '../types/code.types.js';
-
-export interface CodeUnitForScoring {
-  source: string;
-  filePath: string;
-  exports: ExportInfo[];
-  internalDeps: string[];
-  hasTypeAnnotations: boolean;
-}
-
-interface ReusabilitySignal {
-  name: string;
-  weight: number;
-  check: (code: CodeUnitForScoring) => number;
-}
-
-const REUSABILITY_SIGNALS: ReusabilitySignal[] = [
-  {
-    name: 'single_responsibility',
-    weight: 0.25,
-    check: (code) => {
-      const count = code.exports.length;
-      if (count === 0) return 0;
-      if (count <= 3) return 1.0;
-      if (count <= 6) return 0.6;
-      return 0.3;
-    },
-  },
-  {
-    name: 'pure_function',
-    weight: 0.20,
-    check: (code) => {
-      const sideEffects = [
-        'fs.', 'process.', 'console.', 'fetch(',
-        'XMLHttpRequest', 'document.', 'window.',
-        'global.', 'require(',
-      ];
-      const found = sideEffects.filter(se => code.source.includes(se));
-      return found.length === 0 ? 1.0 : Math.max(0, 1 - found.length * 0.3);
-    },
-  },
-  {
-    name: 'clear_interface',
-    weight: 0.20,
-    check: (code) => {
-      let score = 0.5;
-      if (code.hasTypeAnnotations) score += 0.3;
-      if (!code.source.includes(': any')) score += 0.2;
-      return Math.min(1.0, score);
-    },
-  },
-  {
-    name: 'cohesion',
-    weight: 0.15,
-    check: (code) => {
-      const internalImports = code.internalDeps.length;
-      const exportCount = code.exports.length;
-      if (exportCount === 0) return 0;
-      const ratio = internalImports / exportCount;
-      if (ratio === 0) return 1.0;
-      if (ratio < 0.5) return 0.8;
-      if (ratio < 1.0) return 0.5;
-      return 0.2;
-    },
-  },
-  {
-    name: 'generic_utility',
-    weight: 0.10,
-    check: (code) => {
-      const utilPaths = ['utils/', 'helpers/', 'lib/', 'shared/', 'common/'];
-      const isUtilPath = utilPaths.some(p => code.filePath.includes(p));
-      const hasGenerics = /<[A-Z]\w*>/.test(code.source);
-      let score = 0;
-      if (isUtilPath) score += 0.6;
-      if (hasGenerics) score += 0.4;
-      return Math.min(1.0, score || 0.2);
-    },
-  },
-  {
-    name: 'documentation',
-    weight: 0.10,
-    check: (code) => {
-      const hasJsdoc = /\/\*\*[\s\S]*?\*\//.test(code.source);
-      const hasDocstring = /"""[\s\S]*?"""/.test(code.source) || /'''[\s\S]*?'''/.test(code.source);
-      const hasInlineComments = (code.source.match(/\/\/ /g) ?? []).length >= 2;
-      if (hasJsdoc || hasDocstring) return 1.0;
-      if (hasInlineComments) return 0.5;
-      return 0.1;
-    },
-  },
-];
-
-export const MODULE_THRESHOLD = 0.60;
-
-export function computeReusabilityScore(code: CodeUnitForScoring): number {
-  let totalScore = 0;
-  for (const signal of REUSABILITY_SIGNALS) {
-    totalScore += signal.check(code) * signal.weight;
-  }
-  return Math.min(1.0, totalScore);
-}
-
-export function getSignalBreakdown(code: CodeUnitForScoring): Array<{ name: string; score: number; weighted: number }> {
-  return REUSABILITY_SIGNALS.map(signal => {
-    const score = signal.check(code);
-    return { name: signal.name, score, weighted: score * signal.weight };
-  });
-}
+import type { ExportInfo } from '../types/code.types.js';
+
+export interface CodeUnitForScoring {
+  source: string;
+  filePath: string;
+  exports: ExportInfo[];
+  internalDeps: string[];
+  hasTypeAnnotations: boolean;
+}
+
+interface ReusabilitySignal {
+  name: string;
+  weight: number;
+  check: (code: CodeUnitForScoring) => number;
+}
+
+const REUSABILITY_SIGNALS: ReusabilitySignal[] = [
+  {
+    name: 'single_responsibility',
+    weight: 0.25,
+    check: (code) => {
+      const count = code.exports.length;
+      if (count === 0) return 0;
+      if (count <= 3) return 1.0;
+      if (count <= 6) return 0.6;
+      return 0.3;
+    },
+  },
+  {
+    name: 'pure_function',
+    weight: 0.20,
+    check: (code) => {
+      const sideEffects = [
+        'fs.', 'process.', 'console.', 'fetch(',
+        'XMLHttpRequest', 'document.', 'window.',
+        'global.', 'require(',
+      ];
+      const found = sideEffects.filter(se => code.source.includes(se));
+      return found.length === 0 ? 1.0 : Math.max(0, 1 - found.length * 0.3);
+    },
+  },
+  {
+    name: 'clear_interface',
+    weight: 0.20,
+    check: (code) => {
+      let score = 0.5;
+      if (code.hasTypeAnnotations) score += 0.3;
+      if (!code.source.includes(': any')) score += 0.2;
+      return Math.min(1.0, score);
+    },
+  },
+  {
+    name: 'cohesion',
+    weight: 0.15,
+    check: (code) => {
+      const internalImports = code.internalDeps.length;
+      const exportCount = code.exports.length;
+      if (exportCount === 0) return 0;
+      const ratio = internalImports / exportCount;
+      if (ratio === 0) return 1.0;
+      if (ratio < 0.5) return 0.8;
+      if (ratio < 1.0) return 0.5;
+      return 0.2;
+    },
+  },
+  {
+    name: 'generic_utility',
+    weight: 0.10,
+    check: (code) => {
+      const utilPaths = ['utils/', 'helpers/', 'lib/', 'shared/', 'common/'];
+      const isUtilPath = utilPaths.some(p => code.filePath.includes(p));
+      const hasGenerics = /<[A-Z]\w*>/.test(code.source);
+      let score = 0;
+      if (isUtilPath) score += 0.6;
+      if (hasGenerics) score += 0.4;
+      return Math.min(1.0, score || 0.2);
+    },
+  },
+  {
+    name: 'documentation',
+    weight: 0.10,
+    check: (code) => {
+      const hasJsdoc = /\/\*\*[\s\S]*?\*\//.test(code.source);
+      const hasDocstring = /"""[\s\S]*?"""/.test(code.source) || /'''[\s\S]*?'''/.test(code.source);
+      const hasInlineComments = (code.source.match(/\/\/ /g) ?? []).length >= 2;
+      if (hasJsdoc || hasDocstring) return 1.0;
+      if (hasInlineComments) return 0.5;
+      return 0.1;
+    },
+  },
+];
+
+export const MODULE_THRESHOLD = 0.60;
+
+export function computeReusabilityScore(code: CodeUnitForScoring): number {
+  let totalScore = 0;
+  for (const signal of REUSABILITY_SIGNALS) {
+    totalScore += signal.check(code) * signal.weight;
+  }
+  return Math.min(1.0, totalScore);
+}
+
+export function getSignalBreakdown(code: CodeUnitForScoring): Array<{ name: string; score: number; weighted: number }> {
+  return REUSABILITY_SIGNALS.map(signal => {
+    const score = signal.check(code);
+    return { name: signal.name, score, weighted: score * signal.weight };
+  });
+}