@aiready/core 0.5.5 → 0.7.0

package/dist/index.d.mts

@@ -54,6 +54,9 @@ interface AIReadyConfig {
             focus?: 'fragmentation' | 'cohesion' | 'depth' | 'all';
             includeNodeModules?: boolean;
             maxResults?: number;
+            domainKeywords?: string[];
+            domainPatterns?: string[];
+            pathDomainMap?: Record<string, string>;
         };
     };
     output?: {
@@ -76,11 +79,45 @@ interface Report {
     };
 }
 
+declare const DEFAULT_EXCLUDE: string[];
 declare function scanFiles(options: ScanOptions): Promise<string[]>;
 declare function readFileContent(filePath: string): Promise<string>;
 declare function getFileExtension(filePath: string): string;
 declare function isSourceFile(filePath: string): boolean;
 
+interface ExportWithImports {
+    name: string;
+    type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default';
+    imports: string[];
+    dependencies: string[];
+    typeReferences: string[];
+    loc?: {
+        start: {
+            line: number;
+            column: number;
+        };
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+}
+interface FileImport {
+    source: string;
+    specifiers: string[];
+    isTypeOnly: boolean;
+}
+/**
+ * Parse TypeScript/JavaScript file and extract exports with their import dependencies
+ */
+declare function parseFileExports(code: string, filePath: string): {
+    exports: ExportWithImports[];
+    imports: FileImport[];
+};
+/**
+ * Calculate import-based similarity between two exports (Jaccard index)
+ */
+declare function calculateImportSimilarity(export1: ExportWithImports, export2: ExportWithImports): number;
 interface ASTNode {
     type: string;
     loc?: {
@@ -144,4 +181,4 @@ declare function handleCLIError(error: unknown, commandName: string): never;
  */
 declare function getElapsedTime(startTime: number): string;
 
-export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, readFileContent, resolveOutputPath, scanFiles };
+export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, calculateImportSimilarity, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, readFileContent, resolveOutputPath, scanFiles };

package/dist/index.d.ts

@@ -54,6 +54,9 @@ interface AIReadyConfig {
             focus?: 'fragmentation' | 'cohesion' | 'depth' | 'all';
             includeNodeModules?: boolean;
             maxResults?: number;
+            domainKeywords?: string[];
+            domainPatterns?: string[];
+            pathDomainMap?: Record<string, string>;
         };
     };
     output?: {
@@ -76,11 +79,45 @@ interface Report {
     };
 }
 
+declare const DEFAULT_EXCLUDE: string[];
 declare function scanFiles(options: ScanOptions): Promise<string[]>;
 declare function readFileContent(filePath: string): Promise<string>;
 declare function getFileExtension(filePath: string): string;
 declare function isSourceFile(filePath: string): boolean;
 
+interface ExportWithImports {
+    name: string;
+    type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default';
+    imports: string[];
+    dependencies: string[];
+    typeReferences: string[];
+    loc?: {
+        start: {
+            line: number;
+            column: number;
+        };
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+}
+interface FileImport {
+    source: string;
+    specifiers: string[];
+    isTypeOnly: boolean;
+}
+/**
+ * Parse TypeScript/JavaScript file and extract exports with their import dependencies
+ */
+declare function parseFileExports(code: string, filePath: string): {
+    exports: ExportWithImports[];
+    imports: FileImport[];
+};
+/**
+ * Calculate import-based similarity between two exports (Jaccard index)
+ */
+declare function calculateImportSimilarity(export1: ExportWithImports, export2: ExportWithImports): number;
 interface ASTNode {
     type: string;
     loc?: {
@@ -144,4 +181,4 @@ declare function handleCLIError(error: unknown, commandName: string): never;
  */
 declare function getElapsedTime(startTime: number): string;
 
-export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, readFileContent, resolveOutputPath, scanFiles };
+export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, calculateImportSimilarity, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, readFileContent, resolveOutputPath, scanFiles };

package/dist/index.js

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_EXCLUDE: () => DEFAULT_EXCLUDE,
+  calculateImportSimilarity: () => calculateImportSimilarity,
   estimateTokens: () => estimateTokens,
   extractFunctions: () => extractFunctions,
   extractImports: () => extractImports,
@@ -32,6 +34,7 @@ __export(index_exports, {
   loadMergedConfig: () => loadMergedConfig,
   mergeConfigWithDefaults: () => mergeConfigWithDefaults,
   parseCode: () => parseCode,
+  parseFileExports: () => parseFileExports,
   readFileContent: () => readFileContent,
   resolveOutputPath: () => resolveOutputPath,
   scanFiles: () => scanFiles
@@ -85,11 +88,12 @@ async function scanFiles(options) {
   const {
     rootDir,
     include = ["**/*.{ts,tsx,js,jsx,py,java}"],
-    exclude = DEFAULT_EXCLUDE
+    exclude
   } = options;
+  const finalExclude = exclude ? [.../* @__PURE__ */ new Set([...DEFAULT_EXCLUDE, ...exclude])] : DEFAULT_EXCLUDE;
   const files = await (0, import_glob.glob)(include, {
     cwd: rootDir,
-    ignore: exclude,
+    ignore: finalExclude,
     absolute: true
   });
   return files;
@@ -106,6 +110,169 @@ function isSourceFile(filePath) {
 }
 
 // src/utils/ast-parser.ts
+var import_typescript_estree = require("@typescript-eslint/typescript-estree");
+function parseFileExports(code, filePath) {
+  try {
+    const ast = (0, import_typescript_estree.parse)(code, {
+      loc: true,
+      range: true,
+      jsx: filePath.endsWith(".tsx") || filePath.endsWith(".jsx"),
+      filePath
+    });
+    const imports = extractFileImports(ast);
+    const exports2 = extractExportsWithDependencies(ast, imports);
+    return { exports: exports2, imports };
+  } catch (error) {
+    return { exports: [], imports: [] };
+  }
+}
+function extractFileImports(ast) {
+  const imports = [];
+  for (const node of ast.body) {
+    if (node.type === "ImportDeclaration") {
+      const source = node.source.value;
+      const specifiers = [];
+      const isTypeOnly = node.importKind === "type";
+      for (const spec of node.specifiers) {
+        if (spec.type === "ImportSpecifier") {
+          const imported = spec.imported;
+          const importName = imported.type === "Identifier" ? imported.name : imported.value;
+          specifiers.push(importName);
+        } else if (spec.type === "ImportDefaultSpecifier") {
+          specifiers.push("default");
+        } else if (spec.type === "ImportNamespaceSpecifier") {
+          specifiers.push("*");
+        }
+      }
+      imports.push({ source, specifiers, isTypeOnly });
+    }
+  }
+  return imports;
+}
+function extractExportsWithDependencies(ast, fileImports) {
+  const exports2 = [];
+  const importedNames = new Set(fileImports.flatMap((imp) => imp.specifiers));
+  for (const node of ast.body) {
+    if (node.type === "ExportNamedDeclaration") {
+      if (node.declaration) {
+        const exportNodes = extractFromDeclaration(node.declaration);
+        for (const exp of exportNodes) {
+          const usedImports = findUsedImports(node.declaration, importedNames);
+          const typeReferences = extractTypeReferences(node.declaration);
+          exports2.push({
+            ...exp,
+            imports: usedImports,
+            dependencies: [],
+            typeReferences,
+            loc: node.loc
+          });
+        }
+      }
+    } else if (node.type === "ExportDefaultDeclaration") {
+      const usedImports = findUsedImports(node.declaration, importedNames);
+      const typeReferences = extractTypeReferences(node.declaration);
+      exports2.push({
+        name: "default",
+        type: "default",
+        imports: usedImports,
+        dependencies: [],
+        typeReferences,
+        loc: node.loc
+      });
+    }
+  }
+  return exports2;
+}
+function extractFromDeclaration(declaration) {
+  const results = [];
+  if (declaration.type === "FunctionDeclaration" && "id" in declaration && declaration.id) {
+    results.push({ name: declaration.id.name, type: "function" });
+  } else if (declaration.type === "ClassDeclaration" && "id" in declaration && declaration.id) {
+    results.push({ name: declaration.id.name, type: "class" });
+  } else if (declaration.type === "VariableDeclaration") {
+    for (const declarator of declaration.declarations) {
+      if (declarator.id.type === "Identifier") {
+        results.push({ name: declarator.id.name, type: "const" });
+      }
+    }
+  } else if (declaration.type === "TSTypeAliasDeclaration") {
+    results.push({ name: declaration.id.name, type: "type" });
+  } else if (declaration.type === "TSInterfaceDeclaration") {
+    results.push({ name: declaration.id.name, type: "interface" });
+  }
+  return results;
+}
+function findUsedImports(node, importedNames) {
+  const usedImports = /* @__PURE__ */ new Set();
+  function visit(n) {
+    if (n.type === "Identifier" && importedNames.has(n.name)) {
+      usedImports.add(n.name);
+    }
+    for (const key in n) {
+      const value = n[key];
+      if (value && typeof value === "object") {
+        if (Array.isArray(value)) {
+          value.forEach((child) => {
+            if (child && typeof child === "object" && "type" in child) {
+              visit(child);
+            }
+          });
+        } else if ("type" in value) {
+          visit(value);
+        }
+      }
+    }
+  }
+  visit(node);
+  return Array.from(usedImports);
+}
+function calculateImportSimilarity(export1, export2) {
+  if (export1.imports.length === 0 && export2.imports.length === 0) {
+    return 1;
+  }
+  const set1 = new Set(export1.imports);
+  const set2 = new Set(export2.imports);
+  const intersection = new Set([...set1].filter((x) => set2.has(x)));
+  const union = /* @__PURE__ */ new Set([...set1, ...set2]);
+  return intersection.size / union.size;
+}
+function extractTypeReferences(node) {
+  const types = /* @__PURE__ */ new Set();
+  function visit(n) {
+    if (!n || typeof n !== "object") return;
+    if (n.type === "TSTypeReference" && n.typeName) {
+      if (n.typeName.type === "Identifier") {
+        types.add(n.typeName.name);
+      } else if (n.typeName.type === "TSQualifiedName") {
+        let current = n.typeName;
+        while (current.type === "TSQualifiedName") {
+          if (current.right?.type === "Identifier") {
+            types.add(current.right.name);
+          }
+          current = current.left;
+        }
+        if (current.type === "Identifier") {
+          types.add(current.name);
+        }
+      }
+    }
+    if (n.type === "TSInterfaceHeritage" && n.expression) {
+      if (n.expression.type === "Identifier") {
+        types.add(n.expression.name);
+      }
+    }
+    for (const key of Object.keys(n)) {
+      const value = n[key];
+      if (Array.isArray(value)) {
+        value.forEach(visit);
+      } else if (value && typeof value === "object") {
+        visit(value);
+      }
+    }
+  }
+  visit(node);
+  return Array.from(types);
+}
 function parseCode(code, language) {
   return null;
 }
@@ -235,6 +402,8 @@ function getElapsedTime(startTime) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_EXCLUDE,
+  calculateImportSimilarity,
   estimateTokens,
   extractFunctions,
   extractImports,
@@ -247,6 +416,7 @@ function getElapsedTime(startTime) {
   loadMergedConfig,
   mergeConfigWithDefaults,
   parseCode,
+  parseFileExports,
   readFileContent,
   resolveOutputPath,
   scanFiles

package/dist/index.mjs

@@ -52,11 +52,12 @@ async function scanFiles(options) {
   const {
     rootDir,
     include = ["**/*.{ts,tsx,js,jsx,py,java}"],
-    exclude = DEFAULT_EXCLUDE
+    exclude
   } = options;
+  const finalExclude = exclude ? [.../* @__PURE__ */ new Set([...DEFAULT_EXCLUDE, ...exclude])] : DEFAULT_EXCLUDE;
   const files = await glob(include, {
     cwd: rootDir,
-    ignore: exclude,
+    ignore: finalExclude,
     absolute: true
   });
   return files;
@@ -73,6 +74,169 @@ function isSourceFile(filePath) {
 }
 
 // src/utils/ast-parser.ts
+import { parse } from "@typescript-eslint/typescript-estree";
+function parseFileExports(code, filePath) {
+  try {
+    const ast = parse(code, {
+      loc: true,
+      range: true,
+      jsx: filePath.endsWith(".tsx") || filePath.endsWith(".jsx"),
+      filePath
+    });
+    const imports = extractFileImports(ast);
+    const exports = extractExportsWithDependencies(ast, imports);
+    return { exports, imports };
+  } catch (error) {
+    return { exports: [], imports: [] };
+  }
+}
+function extractFileImports(ast) {
+  const imports = [];
+  for (const node of ast.body) {
+    if (node.type === "ImportDeclaration") {
+      const source = node.source.value;
+      const specifiers = [];
+      const isTypeOnly = node.importKind === "type";
+      for (const spec of node.specifiers) {
+        if (spec.type === "ImportSpecifier") {
+          const imported = spec.imported;
+          const importName = imported.type === "Identifier" ? imported.name : imported.value;
+          specifiers.push(importName);
+        } else if (spec.type === "ImportDefaultSpecifier") {
+          specifiers.push("default");
+        } else if (spec.type === "ImportNamespaceSpecifier") {
+          specifiers.push("*");
+        }
+      }
+      imports.push({ source, specifiers, isTypeOnly });
+    }
+  }
+  return imports;
+}
+function extractExportsWithDependencies(ast, fileImports) {
+  const exports = [];
+  const importedNames = new Set(fileImports.flatMap((imp) => imp.specifiers));
+  for (const node of ast.body) {
+    if (node.type === "ExportNamedDeclaration") {
+      if (node.declaration) {
+        const exportNodes = extractFromDeclaration(node.declaration);
+        for (const exp of exportNodes) {
+          const usedImports = findUsedImports(node.declaration, importedNames);
+          const typeReferences = extractTypeReferences(node.declaration);
+          exports.push({
+            ...exp,
+            imports: usedImports,
+            dependencies: [],
+            typeReferences,
+            loc: node.loc
+          });
+        }
+      }
+    } else if (node.type === "ExportDefaultDeclaration") {
+      const usedImports = findUsedImports(node.declaration, importedNames);
+      const typeReferences = extractTypeReferences(node.declaration);
+      exports.push({
+        name: "default",
+        type: "default",
+        imports: usedImports,
+        dependencies: [],
+        typeReferences,
+        loc: node.loc
+      });
+    }
+  }
+  return exports;
+}
+function extractFromDeclaration(declaration) {
+  const results = [];
+  if (declaration.type === "FunctionDeclaration" && "id" in declaration && declaration.id) {
+    results.push({ name: declaration.id.name, type: "function" });
+  } else if (declaration.type === "ClassDeclaration" && "id" in declaration && declaration.id) {
+    results.push({ name: declaration.id.name, type: "class" });
+  } else if (declaration.type === "VariableDeclaration") {
+    for (const declarator of declaration.declarations) {
+      if (declarator.id.type === "Identifier") {
+        results.push({ name: declarator.id.name, type: "const" });
+      }
+    }
+  } else if (declaration.type === "TSTypeAliasDeclaration") {
+    results.push({ name: declaration.id.name, type: "type" });
+  } else if (declaration.type === "TSInterfaceDeclaration") {
+    results.push({ name: declaration.id.name, type: "interface" });
+  }
+  return results;
+}
+function findUsedImports(node, importedNames) {
+  const usedImports = /* @__PURE__ */ new Set();
+  function visit(n) {
+    if (n.type === "Identifier" && importedNames.has(n.name)) {
+      usedImports.add(n.name);
+    }
+    for (const key in n) {
+      const value = n[key];
+      if (value && typeof value === "object") {
+        if (Array.isArray(value)) {
+          value.forEach((child) => {
+            if (child && typeof child === "object" && "type" in child) {
+              visit(child);
+            }
+          });
+        } else if ("type" in value) {
+          visit(value);
+        }
+      }
+    }
+  }
+  visit(node);
+  return Array.from(usedImports);
+}
+function calculateImportSimilarity(export1, export2) {
+  if (export1.imports.length === 0 && export2.imports.length === 0) {
+    return 1;
+  }
+  const set1 = new Set(export1.imports);
+  const set2 = new Set(export2.imports);
+  const intersection = new Set([...set1].filter((x) => set2.has(x)));
+  const union = /* @__PURE__ */ new Set([...set1, ...set2]);
+  return intersection.size / union.size;
+}
+function extractTypeReferences(node) {
+  const types = /* @__PURE__ */ new Set();
+  function visit(n) {
+    if (!n || typeof n !== "object") return;
+    if (n.type === "TSTypeReference" && n.typeName) {
+      if (n.typeName.type === "Identifier") {
+        types.add(n.typeName.name);
+      } else if (n.typeName.type === "TSQualifiedName") {
+        let current = n.typeName;
+        while (current.type === "TSQualifiedName") {
+          if (current.right?.type === "Identifier") {
+            types.add(current.right.name);
+          }
+          current = current.left;
+        }
+        if (current.type === "Identifier") {
+          types.add(current.name);
+        }
+      }
+    }
+    if (n.type === "TSInterfaceHeritage" && n.expression) {
+      if (n.expression.type === "Identifier") {
+        types.add(n.expression.name);
+      }
+    }
+    for (const key of Object.keys(n)) {
+      const value = n[key];
+      if (Array.isArray(value)) {
+        value.forEach(visit);
+      } else if (value && typeof value === "object") {
+        visit(value);
+      }
+    }
+  }
+  visit(node);
+  return Array.from(types);
+}
 function parseCode(code, language) {
   return null;
 }
@@ -201,6 +365,8 @@ function getElapsedTime(startTime) {
   return ((Date.now() - startTime) / 1e3).toFixed(2);
 }
 export {
+  DEFAULT_EXCLUDE,
+  calculateImportSimilarity,
   estimateTokens,
   extractFunctions,
   extractImports,
@@ -213,6 +379,7 @@ export {
   loadMergedConfig,
   mergeConfigWithDefaults,
   parseCode,
+  parseFileExports,
   readFileContent,
   resolveOutputPath,
   scanFiles

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.5.5",
+  "version": "0.7.0",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -12,6 +12,14 @@
       "import": "./dist/index.mjs"
     }
   },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint src",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm build",
+    "release": "pnpm build && pnpm publish --no-git-checks"
+  },
   "keywords": [
     "aiready",
     "code-analysis",
@@ -34,18 +42,14 @@
     "CONTRIBUTING.md"
   ],
   "devDependencies": {
-    "tsup": "^8.3.5",
-    "eslint": "^9.17.0"
+    "eslint": "^9.17.0",
+    "tsup": "^8.3.5"
   },
   "dependencies": {
+    "@typescript-eslint/parser": "^8.53.0",
+    "@typescript-eslint/typescript-estree": "^8.53.0",
+    "chalk": "^5.4.1",
     "glob": "^13.0.0",
-    "chalk": "^5.4.1"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint src",
-    "clean": "rm -rf dist",
-    "release": "pnpm build && pnpm publish --no-git-checks"
+    "typescript": "^5.9.3"
   }
-}
+}