apdev-js 0.2.0 → 0.2.2

package/README.md

@@ -1,6 +1,6 @@
 # apdev
 
-Shared development tools for TypeScript/JavaScript projects - character validation, circular import detection, and more.
+General-purpose development tools for TypeScript/JavaScript projects - character validation, circular import detection, and more.
 
 ## Installation
 

package/dist/cli.js

@@ -15,7 +15,7 @@ import { execFileSync } from "child_process";
 import { Command } from "commander";
 
 // src/check-chars.ts
-import { readFileSync, existsSync } from "fs";
+import { readFileSync, existsSync, readdirSync, statSync } from "fs";
 import { extname, dirname, join, sep } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getCharsetsDir() {
@@ -259,10 +259,164 @@ function checkFile(filePath, maxProblems = 5, extraRanges, dangerousMap) {
   }
   return problems;
 }
+var SKIP_SUFFIXES = /* @__PURE__ */ new Set([
+  // Bytecode
+  ".pyc",
+  ".pyo",
+  // Images
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".bmp",
+  ".ico",
+  ".svg",
+  ".webp",
+  // Fonts
+  ".ttf",
+  ".otf",
+  ".woff",
+  ".woff2",
+  ".eot",
+  // Archives
+  ".zip",
+  ".tar",
+  ".gz",
+  ".bz2",
+  ".xz",
+  ".7z",
+  // Compiled / binary
+  ".so",
+  ".dylib",
+  ".dll",
+  ".exe",
+  ".o",
+  ".a",
+  ".whl",
+  ".egg",
+  // Media
+  ".mp3",
+  ".mp4",
+  ".wav",
+  ".avi",
+  ".mov",
+  ".flac",
+  ".ogg",
+  // Documents
+  ".pdf",
+  ".doc",
+  ".docx",
+  ".xls",
+  ".xlsx",
+  ".ppt",
+  ".pptx",
+  // Data
+  ".db",
+  ".sqlite",
+  ".sqlite3",
+  ".pickle",
+  ".pkl"
+]);
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "__pycache__",
+  "node_modules",
+  ".git",
+  ".venv",
+  "venv",
+  ".tox",
+  ".mypy_cache",
+  ".pytest_cache",
+  ".ruff_cache",
+  "dist",
+  "build"
+]);
+var DEFAULT_DIRS = ["src", "tests", "examples"];
+var DEFAULT_GLOBS = ["*.md", "*.yml", "*.yaml", "*.json", ".gitignore"];
+function walkDir(directory) {
+  const files = [];
+  let entries;
+  try {
+    entries = readdirSync(directory).sort();
+  } catch {
+    return files;
+  }
+  for (const name of entries) {
+    if (name.startsWith(".")) continue;
+    const fullPath = join(directory, name);
+    let stat;
+    try {
+      stat = statSync(fullPath);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      if (SKIP_DIRS.has(name) || name.endsWith(".egg-info")) continue;
+      files.push(...walkDir(fullPath));
+    } else if (stat.isFile()) {
+      if (SKIP_SUFFIXES.has(extname(name).toLowerCase())) continue;
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+function defaultProjectFiles() {
+  const cwd = process.cwd();
+  const files = [];
+  for (const dirname3 of DEFAULT_DIRS) {
+    const d = join(cwd, dirname3);
+    if (existsSync(d) && statSync(d).isDirectory()) {
+      files.push(...walkDir(d));
+    }
+  }
+  for (const pattern of DEFAULT_GLOBS) {
+    if (pattern.startsWith("*.")) {
+      const suffix = pattern.slice(1);
+      try {
+        for (const name of readdirSync(cwd).sort()) {
+          if (name.endsWith(suffix) && statSync(join(cwd, name)).isFile()) {
+            files.push(join(cwd, name));
+          }
+        }
+      } catch {
+      }
+    } else {
+      const fullPath = join(cwd, pattern);
+      if (existsSync(fullPath) && statSync(fullPath).isFile()) {
+        files.push(fullPath);
+      }
+    }
+  }
+  return files;
+}
+function resolvePaths(paths) {
+  if (paths.length === 0) {
+    return defaultProjectFiles();
+  }
+  const result = [];
+  for (const p of paths) {
+    try {
+      if (statSync(p).isDirectory()) {
+        result.push(...walkDir(p));
+      } else {
+        result.push(p);
+      }
+    } catch {
+      result.push(p);
+    }
+  }
+  return result;
+}
 function checkPaths(paths, extraRanges, dangerousMap) {
+  const resolved = resolvePaths(paths);
+  if (resolved.length === 0) {
+    console.log("No files to check.");
+    return 0;
+  }
   let hasError = false;
-  for (const path2 of paths) {
+  let checked = 0;
+  for (const path2 of resolved) {
     const problems = checkFile(path2, 5, extraRanges, dangerousMap);
+    checked++;
     if (problems.length > 0) {
       hasError = true;
       console.log(`
@@ -272,13 +426,27 @@ ${path2} contains illegal characters:`);
       }
     }
   }
+  if (!hasError) {
+    console.log(`All ${checked} files passed.`);
+  }
   return hasError ? 1 : 0;
 }
 
 // src/check-imports.ts
-import { readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { readFileSync as readFileSync2, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
 import { join as join2, relative, sep as sep2, extname as extname2, basename } from "path";
-import ts from "typescript";
+var _ts;
+async function loadTS() {
+  if (_ts) return _ts;
+  try {
+    _ts = (await import("typescript")).default;
+    return _ts;
+  } catch {
+    throw new Error(
+      "The 'typescript' package is required for circular import detection.\nInstall it with: npm install -g typescript\nOr locally:      npm install -D typescript"
+    );
+  }
+}
 var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ts",
   ".tsx",
@@ -307,7 +475,8 @@ function fileToModule(filePath, srcDir) {
   }
   return parts.join(".");
 }
-function extractImports(source, fileName) {
+async function extractImports(source, fileName) {
+  const ts = await loadTS();
   const imports = /* @__PURE__ */ new Set();
   const sourceFile = ts.createSourceFile(
     fileName,
@@ -365,13 +534,13 @@ function resolveImports(rawImports, basePackage, currentModule, isPackage) {
 function findSourceFiles(dir) {
   const results = [];
   function walk(d) {
-    const entries = readdirSync(d);
+    const entries = readdirSync2(d);
     for (const entry of entries) {
       if (entry === "node_modules" || entry === "dist" || entry === ".git") {
         continue;
       }
       const full = join2(d, entry);
-      const stat = statSync(full);
+      const stat = statSync2(full);
       if (stat.isDirectory()) {
         walk(full);
       } else if (SUPPORTED_EXTENSIONS.has(extname2(entry))) {
@@ -382,7 +551,7 @@ function findSourceFiles(dir) {
   walk(dir);
   return results;
 }
-function buildDependencyGraph(srcDir, basePackage) {
+async function buildDependencyGraph(srcDir, basePackage) {
   const graph = /* @__PURE__ */ new Map();
   const files = findSourceFiles(srcDir);
   for (const file of files) {
@@ -397,7 +566,7 @@ function buildDependencyGraph(srcDir, basePackage) {
     }
     let rawImports;
     try {
-      rawImports = extractImports(source, file);
+      rawImports = await extractImports(source, file);
     } catch (e) {
       console.error(`Warning: could not parse ${file}: ${e}`);
       continue;
@@ -456,10 +625,10 @@ function findCycles(graph) {
   }
   return unique;
 }
-function checkCircularImports(srcDir, basePackage) {
+async function checkCircularImports(srcDir, basePackage) {
   let stat;
   try {
-    stat = statSync(srcDir);
+    stat = statSync2(srcDir);
   } catch {
     console.error(`Error: ${srcDir}/ directory not found`);
     return 1;
@@ -468,7 +637,7 @@ function checkCircularImports(srcDir, basePackage) {
     console.error(`Error: ${srcDir}/ is not a directory`);
     return 1;
   }
-  const graph = buildDependencyGraph(srcDir, basePackage);
+  const graph = await buildDependencyGraph(srcDir, basePackage);
   console.log(`Scanned ${graph.size} modules`);
   const cycles = findCycles(graph);
   if (cycles.length > 0) {
@@ -526,7 +695,7 @@ function getReleaseScript() {
 function buildProgram() {
   const program2 = new Command();
   program2.name("apdev").description("Shared development tools for TypeScript/JavaScript projects").version(getVersion());
-  program2.command("check-chars").description("Validate files contain only allowed characters").argument("<files...>", "Files to check").option("--charset <name>", "Extra charset preset (repeatable)", collect, []).option("--charset-file <path>", "Custom charset JSON file (repeatable)", collect, []).action((files, opts) => {
+  program2.command("check-chars").description("Validate files contain only allowed characters").argument("[files...]", "Files or directories to check (defaults to src/, tests/, examples/ and config files)").option("--charset <name>", "Extra charset preset (repeatable)", collect, []).option("--charset-file <path>", "Custom charset JSON file (repeatable)", collect, []).action((files, opts) => {
     let charsetNames = opts.charset;
     let charsetFiles = opts.charsetFile;
     if (charsetNames.length === 0 && charsetFiles.length === 0) {
@@ -548,7 +717,7 @@ function buildProgram() {
     const code = checkPaths(resolved, ranges, dangerous);
     process.exit(code);
   });
-  program2.command("check-imports").description("Detect circular imports in a JS/TS package").option("--package <name>", "Base package name (e.g. mylib). Reads from package.json apdev config if omitted.").option("--src-dir <dir>", "Source directory containing the package (default: src)").action((opts) => {
+  program2.command("check-imports").description("Detect circular imports in a JS/TS package").option("--package <name>", "Base package name (e.g. mylib). Reads from package.json apdev config if omitted.").option("--src-dir <dir>", "Source directory containing the package (default: src)").action(async (opts) => {
     const config = loadConfig();
     const basePackage = opts.package ?? config["base_package"];
     const srcDir = opts.srcDir ?? config["src_dir"] ?? "src";
@@ -558,7 +727,7 @@ function buildProgram() {
       );
       process.exit(1);
     }
-    const code = checkCircularImports(resolve(srcDir), basePackage);
+    const code = await checkCircularImports(resolve(srcDir), basePackage);
     process.exit(code);
   });
   program2.command("release").description("Interactive release automation (build, tag, GitHub release, npm publish)").option("-y, --yes", "Auto-accept all defaults (silent mode)").argument("[version]", "Version to release (auto-detected from package.json if omitted)").action((version, opts) => {

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(src_exports, {
   loadCharset: () => loadCharset,
   loadConfig: () => loadConfig,
   resolveCharsets: () => resolveCharsets,
+  resolvePaths: () => resolvePaths,
   version: () => version
 });
 module.exports = __toCommonJS(src_exports);
@@ -304,10 +305,164 @@ function checkFile(filePath, maxProblems = 5, extraRanges, dangerousMap) {
   }
   return problems;
 }
+var SKIP_SUFFIXES = /* @__PURE__ */ new Set([
+  // Bytecode
+  ".pyc",
+  ".pyo",
+  // Images
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".bmp",
+  ".ico",
+  ".svg",
+  ".webp",
+  // Fonts
+  ".ttf",
+  ".otf",
+  ".woff",
+  ".woff2",
+  ".eot",
+  // Archives
+  ".zip",
+  ".tar",
+  ".gz",
+  ".bz2",
+  ".xz",
+  ".7z",
+  // Compiled / binary
+  ".so",
+  ".dylib",
+  ".dll",
+  ".exe",
+  ".o",
+  ".a",
+  ".whl",
+  ".egg",
+  // Media
+  ".mp3",
+  ".mp4",
+  ".wav",
+  ".avi",
+  ".mov",
+  ".flac",
+  ".ogg",
+  // Documents
+  ".pdf",
+  ".doc",
+  ".docx",
+  ".xls",
+  ".xlsx",
+  ".ppt",
+  ".pptx",
+  // Data
+  ".db",
+  ".sqlite",
+  ".sqlite3",
+  ".pickle",
+  ".pkl"
+]);
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "__pycache__",
+  "node_modules",
+  ".git",
+  ".venv",
+  "venv",
+  ".tox",
+  ".mypy_cache",
+  ".pytest_cache",
+  ".ruff_cache",
+  "dist",
+  "build"
+]);
+var DEFAULT_DIRS = ["src", "tests", "examples"];
+var DEFAULT_GLOBS = ["*.md", "*.yml", "*.yaml", "*.json", ".gitignore"];
+function walkDir(directory) {
+  const files = [];
+  let entries;
+  try {
+    entries = (0, import_node_fs.readdirSync)(directory).sort();
+  } catch {
+    return files;
+  }
+  for (const name of entries) {
+    if (name.startsWith(".")) continue;
+    const fullPath = (0, import_node_path.join)(directory, name);
+    let stat;
+    try {
+      stat = (0, import_node_fs.statSync)(fullPath);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      if (SKIP_DIRS.has(name) || name.endsWith(".egg-info")) continue;
+      files.push(...walkDir(fullPath));
+    } else if (stat.isFile()) {
+      if (SKIP_SUFFIXES.has((0, import_node_path.extname)(name).toLowerCase())) continue;
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+function defaultProjectFiles() {
+  const cwd = process.cwd();
+  const files = [];
+  for (const dirname3 of DEFAULT_DIRS) {
+    const d = (0, import_node_path.join)(cwd, dirname3);
+    if ((0, import_node_fs.existsSync)(d) && (0, import_node_fs.statSync)(d).isDirectory()) {
+      files.push(...walkDir(d));
+    }
+  }
+  for (const pattern of DEFAULT_GLOBS) {
+    if (pattern.startsWith("*.")) {
+      const suffix = pattern.slice(1);
+      try {
+        for (const name of (0, import_node_fs.readdirSync)(cwd).sort()) {
+          if (name.endsWith(suffix) && (0, import_node_fs.statSync)((0, import_node_path.join)(cwd, name)).isFile()) {
+            files.push((0, import_node_path.join)(cwd, name));
+          }
+        }
+      } catch {
+      }
+    } else {
+      const fullPath = (0, import_node_path.join)(cwd, pattern);
+      if ((0, import_node_fs.existsSync)(fullPath) && (0, import_node_fs.statSync)(fullPath).isFile()) {
+        files.push(fullPath);
+      }
+    }
+  }
+  return files;
+}
+function resolvePaths(paths) {
+  if (paths.length === 0) {
+    return defaultProjectFiles();
+  }
+  const result = [];
+  for (const p of paths) {
+    try {
+      if ((0, import_node_fs.statSync)(p).isDirectory()) {
+        result.push(...walkDir(p));
+      } else {
+        result.push(p);
+      }
+    } catch {
+      result.push(p);
+    }
+  }
+  return result;
+}
 function checkPaths(paths, extraRanges, dangerousMap) {
+  const resolved = resolvePaths(paths);
+  if (resolved.length === 0) {
+    console.log("No files to check.");
+    return 0;
+  }
   let hasError = false;
-  for (const path of paths) {
+  let checked = 0;
+  for (const path of resolved) {
     const problems = checkFile(path, 5, extraRanges, dangerousMap);
+    checked++;
     if (problems.length > 0) {
       hasError = true;
       console.log(`
@@ -317,13 +472,27 @@ ${path} contains illegal characters:`);
       }
     }
   }
+  if (!hasError) {
+    console.log(`All ${checked} files passed.`);
+  }
   return hasError ? 1 : 0;
 }
 
 // src/check-imports.ts
 var import_node_fs2 = require("fs");
 var import_node_path2 = require("path");
-var import_typescript = __toESM(require("typescript"), 1);
+var _ts;
+async function loadTS() {
+  if (_ts) return _ts;
+  try {
+    _ts = (await import("typescript")).default;
+    return _ts;
+  } catch {
+    throw new Error(
+      "The 'typescript' package is required for circular import detection.\nInstall it with: npm install -g typescript\nOr locally:      npm install -D typescript"
+    );
+  }
+}
 var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ts",
   ".tsx",
@@ -352,26 +521,27 @@ function fileToModule(filePath, srcDir) {
   }
   return parts.join(".");
 }
-function extractImports(source, fileName) {
+async function extractImports(source, fileName) {
+  const ts = await loadTS();
   const imports = /* @__PURE__ */ new Set();
-  const sourceFile = import_typescript.default.createSourceFile(
+  const sourceFile = ts.createSourceFile(
     fileName,
     source,
-    import_typescript.default.ScriptTarget.Latest,
+    ts.ScriptTarget.Latest,
     true,
-    fileName.endsWith(".tsx") || fileName.endsWith(".jsx") ? import_typescript.default.ScriptKind.TSX : void 0
+    fileName.endsWith(".tsx") || fileName.endsWith(".jsx") ? ts.ScriptKind.TSX : void 0
   );
   function visit(node) {
-    if (import_typescript.default.isImportDeclaration(node) && import_typescript.default.isStringLiteral(node.moduleSpecifier)) {
+    if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
       imports.add(node.moduleSpecifier.text);
     }
-    if (import_typescript.default.isExportDeclaration(node) && node.moduleSpecifier && import_typescript.default.isStringLiteral(node.moduleSpecifier)) {
+    if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier)) {
       imports.add(node.moduleSpecifier.text);
     }
-    if (import_typescript.default.isCallExpression(node) && node.expression.kind === import_typescript.default.SyntaxKind.Identifier && node.expression.text === "require" && node.arguments.length === 1 && import_typescript.default.isStringLiteral(node.arguments[0])) {
+    if (ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.Identifier && node.expression.text === "require" && node.arguments.length === 1 && ts.isStringLiteral(node.arguments[0])) {
       imports.add(node.arguments[0].text);
     }
-    import_typescript.default.forEachChild(node, visit);
+    ts.forEachChild(node, visit);
   }
   visit(sourceFile);
   return imports;
@@ -427,7 +597,7 @@ function findSourceFiles(dir) {
   walk(dir);
   return results;
 }
-function buildDependencyGraph(srcDir, basePackage) {
+async function buildDependencyGraph(srcDir, basePackage) {
   const graph = /* @__PURE__ */ new Map();
   const files = findSourceFiles(srcDir);
   for (const file of files) {
@@ -442,7 +612,7 @@ function buildDependencyGraph(srcDir, basePackage) {
     }
     let rawImports;
     try {
-      rawImports = extractImports(source, file);
+      rawImports = await extractImports(source, file);
     } catch (e) {
       console.error(`Warning: could not parse ${file}: ${e}`);
       continue;
@@ -501,7 +671,7 @@ function findCycles(graph) {
   }
   return unique;
 }
-function checkCircularImports(srcDir, basePackage) {
+async function checkCircularImports(srcDir, basePackage) {
   let stat;
   try {
     stat = (0, import_node_fs2.statSync)(srcDir);
@@ -513,7 +683,7 @@ function checkCircularImports(srcDir, basePackage) {
     console.error(`Error: ${srcDir}/ is not a directory`);
     return 1;
   }
-  const graph = buildDependencyGraph(srcDir, basePackage);
+  const graph = await buildDependencyGraph(srcDir, basePackage);
   console.log(`Scanned ${graph.size} modules`);
   const cycles = findCycles(graph);
   if (cycles.length > 0) {
@@ -577,5 +747,6 @@ var version = readVersion();
   loadCharset,
   loadConfig,
   resolveCharsets,
+  resolvePaths,
   version
 });

package/dist/index.d.cts

@@ -42,6 +42,7 @@ declare function isDangerousChar(c: string): boolean;
  * Returns a list of problem descriptions (empty if the file is clean).
  */
 declare function checkFile(filePath: string, maxProblems?: number, extraRanges?: [number, number][], dangerousMap?: Map<number, string>): string[];
+declare function resolvePaths(paths: string[]): string[];
 /**
  * Check multiple files. Returns 0 if all clean, 1 if any have problems.
  */
@@ -56,11 +57,11 @@ declare function checkPaths(paths: string[], extraRanges?: [number, number][], d
 /** Convert a file path to a dotted module name (relative to srcDir). */
 declare function fileToModule(filePath: string, srcDir: string): string;
 /** Build a module-to-module dependency graph for the given package. */
-declare function buildDependencyGraph(srcDir: string, basePackage: string): Map<string, Set<string>>;
+declare function buildDependencyGraph(srcDir: string, basePackage: string): Promise<Map<string, Set<string>>>;
 /** Find all elementary cycles in the dependency graph using DFS. */
 declare function findCycles(graph: Map<string, Set<string>>): string[][];
 /** Run circular import detection. Returns 0 if clean, 1 if cycles found. */
-declare function checkCircularImports(srcDir: string, basePackage: string): number;
+declare function checkCircularImports(srcDir: string, basePackage: string): Promise<number>;
 
 /**
  * Configuration loading for apdev.
@@ -75,4 +76,4 @@ declare function loadConfig(projectDir?: string): Record<string, unknown>;
 
 declare const version: string;
 
-export { buildDependencyGraph, checkCircularImports, checkFile, checkPaths, fileToModule, findCycles, isAllowedChar, isDangerousChar, loadCharset, loadConfig, resolveCharsets, version };
+export { buildDependencyGraph, checkCircularImports, checkFile, checkPaths, fileToModule, findCycles, isAllowedChar, isDangerousChar, loadCharset, loadConfig, resolveCharsets, resolvePaths, version };

package/dist/index.d.ts

@@ -42,6 +42,7 @@ declare function isDangerousChar(c: string): boolean;
  * Returns a list of problem descriptions (empty if the file is clean).
  */
 declare function checkFile(filePath: string, maxProblems?: number, extraRanges?: [number, number][], dangerousMap?: Map<number, string>): string[];
+declare function resolvePaths(paths: string[]): string[];
 /**
  * Check multiple files. Returns 0 if all clean, 1 if any have problems.
  */
@@ -56,11 +57,11 @@ declare function checkPaths(paths: string[], extraRanges?: [number, number][], d
 /** Convert a file path to a dotted module name (relative to srcDir). */
 declare function fileToModule(filePath: string, srcDir: string): string;
 /** Build a module-to-module dependency graph for the given package. */
-declare function buildDependencyGraph(srcDir: string, basePackage: string): Map<string, Set<string>>;
+declare function buildDependencyGraph(srcDir: string, basePackage: string): Promise<Map<string, Set<string>>>;
 /** Find all elementary cycles in the dependency graph using DFS. */
 declare function findCycles(graph: Map<string, Set<string>>): string[][];
 /** Run circular import detection. Returns 0 if clean, 1 if cycles found. */
-declare function checkCircularImports(srcDir: string, basePackage: string): number;
+declare function checkCircularImports(srcDir: string, basePackage: string): Promise<number>;
 
 /**
  * Configuration loading for apdev.
@@ -75,4 +76,4 @@ declare function loadConfig(projectDir?: string): Record<string, unknown>;
 
 declare const version: string;
 
-export { buildDependencyGraph, checkCircularImports, checkFile, checkPaths, fileToModule, findCycles, isAllowedChar, isDangerousChar, loadCharset, loadConfig, resolveCharsets, version };
+export { buildDependencyGraph, checkCircularImports, checkFile, checkPaths, fileToModule, findCycles, isAllowedChar, isDangerousChar, loadCharset, loadConfig, resolveCharsets, resolvePaths, version };

package/dist/index.js

@@ -6,7 +6,7 @@ var getDirname = () => path.dirname(getFilename());
 var __dirname = /* @__PURE__ */ getDirname();
 
 // src/check-chars.ts
-import { readFileSync, existsSync } from "fs";
+import { readFileSync, existsSync, readdirSync, statSync } from "fs";
 import { extname, dirname, join, sep } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getCharsetsDir() {
@@ -260,10 +260,164 @@ function checkFile(filePath, maxProblems = 5, extraRanges, dangerousMap) {
   }
   return problems;
 }
+var SKIP_SUFFIXES = /* @__PURE__ */ new Set([
+  // Bytecode
+  ".pyc",
+  ".pyo",
+  // Images
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".bmp",
+  ".ico",
+  ".svg",
+  ".webp",
+  // Fonts
+  ".ttf",
+  ".otf",
+  ".woff",
+  ".woff2",
+  ".eot",
+  // Archives
+  ".zip",
+  ".tar",
+  ".gz",
+  ".bz2",
+  ".xz",
+  ".7z",
+  // Compiled / binary
+  ".so",
+  ".dylib",
+  ".dll",
+  ".exe",
+  ".o",
+  ".a",
+  ".whl",
+  ".egg",
+  // Media
+  ".mp3",
+  ".mp4",
+  ".wav",
+  ".avi",
+  ".mov",
+  ".flac",
+  ".ogg",
+  // Documents
+  ".pdf",
+  ".doc",
+  ".docx",
+  ".xls",
+  ".xlsx",
+  ".ppt",
+  ".pptx",
+  // Data
+  ".db",
+  ".sqlite",
+  ".sqlite3",
+  ".pickle",
+  ".pkl"
+]);
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "__pycache__",
+  "node_modules",
+  ".git",
+  ".venv",
+  "venv",
+  ".tox",
+  ".mypy_cache",
+  ".pytest_cache",
+  ".ruff_cache",
+  "dist",
+  "build"
+]);
+var DEFAULT_DIRS = ["src", "tests", "examples"];
+var DEFAULT_GLOBS = ["*.md", "*.yml", "*.yaml", "*.json", ".gitignore"];
+function walkDir(directory) {
+  const files = [];
+  let entries;
+  try {
+    entries = readdirSync(directory).sort();
+  } catch {
+    return files;
+  }
+  for (const name of entries) {
+    if (name.startsWith(".")) continue;
+    const fullPath = join(directory, name);
+    let stat;
+    try {
+      stat = statSync(fullPath);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      if (SKIP_DIRS.has(name) || name.endsWith(".egg-info")) continue;
+      files.push(...walkDir(fullPath));
+    } else if (stat.isFile()) {
+      if (SKIP_SUFFIXES.has(extname(name).toLowerCase())) continue;
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+function defaultProjectFiles() {
+  const cwd = process.cwd();
+  const files = [];
+  for (const dirname3 of DEFAULT_DIRS) {
+    const d = join(cwd, dirname3);
+    if (existsSync(d) && statSync(d).isDirectory()) {
+      files.push(...walkDir(d));
+    }
+  }
+  for (const pattern of DEFAULT_GLOBS) {
+    if (pattern.startsWith("*.")) {
+      const suffix = pattern.slice(1);
+      try {
+        for (const name of readdirSync(cwd).sort()) {
+          if (name.endsWith(suffix) && statSync(join(cwd, name)).isFile()) {
+            files.push(join(cwd, name));
+          }
+        }
+      } catch {
+      }
+    } else {
+      const fullPath = join(cwd, pattern);
+      if (existsSync(fullPath) && statSync(fullPath).isFile()) {
+        files.push(fullPath);
+      }
+    }
+  }
+  return files;
+}
+function resolvePaths(paths) {
+  if (paths.length === 0) {
+    return defaultProjectFiles();
+  }
+  const result = [];
+  for (const p of paths) {
+    try {
+      if (statSync(p).isDirectory()) {
+        result.push(...walkDir(p));
+      } else {
+        result.push(p);
+      }
+    } catch {
+      result.push(p);
+    }
+  }
+  return result;
+}
 function checkPaths(paths, extraRanges, dangerousMap) {
+  const resolved = resolvePaths(paths);
+  if (resolved.length === 0) {
+    console.log("No files to check.");
+    return 0;
+  }
   let hasError = false;
-  for (const path2 of paths) {
+  let checked = 0;
+  for (const path2 of resolved) {
     const problems = checkFile(path2, 5, extraRanges, dangerousMap);
+    checked++;
     if (problems.length > 0) {
       hasError = true;
       console.log(`
@@ -273,13 +427,27 @@ ${path2} contains illegal characters:`);
       }
     }
   }
+  if (!hasError) {
+    console.log(`All ${checked} files passed.`);
+  }
   return hasError ? 1 : 0;
 }
 
 // src/check-imports.ts
-import { readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { readFileSync as readFileSync2, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
 import { join as join2, relative, sep as sep2, extname as extname2, basename } from "path";
-import ts from "typescript";
+var _ts;
+async function loadTS() {
+  if (_ts) return _ts;
+  try {
+    _ts = (await import("typescript")).default;
+    return _ts;
+  } catch {
+    throw new Error(
+      "The 'typescript' package is required for circular import detection.\nInstall it with: npm install -g typescript\nOr locally:      npm install -D typescript"
+    );
+  }
+}
 var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ts",
   ".tsx",
@@ -308,7 +476,8 @@ function fileToModule(filePath, srcDir) {
   }
   return parts.join(".");
 }
-function extractImports(source, fileName) {
+async function extractImports(source, fileName) {
+  const ts = await loadTS();
   const imports = /* @__PURE__ */ new Set();
   const sourceFile = ts.createSourceFile(
     fileName,
@@ -366,13 +535,13 @@ function resolveImports(rawImports, basePackage, currentModule, isPackage) {
 function findSourceFiles(dir) {
   const results = [];
   function walk(d) {
-    const entries = readdirSync(d);
+    const entries = readdirSync2(d);
     for (const entry of entries) {
       if (entry === "node_modules" || entry === "dist" || entry === ".git") {
         continue;
       }
       const full = join2(d, entry);
-      const stat = statSync(full);
+      const stat = statSync2(full);
       if (stat.isDirectory()) {
         walk(full);
       } else if (SUPPORTED_EXTENSIONS.has(extname2(entry))) {
@@ -383,7 +552,7 @@ function findSourceFiles(dir) {
   walk(dir);
   return results;
 }
-function buildDependencyGraph(srcDir, basePackage) {
+async function buildDependencyGraph(srcDir, basePackage) {
   const graph = /* @__PURE__ */ new Map();
   const files = findSourceFiles(srcDir);
   for (const file of files) {
@@ -398,7 +567,7 @@ function buildDependencyGraph(srcDir, basePackage) {
     }
     let rawImports;
     try {
-      rawImports = extractImports(source, file);
+      rawImports = await extractImports(source, file);
     } catch (e) {
       console.error(`Warning: could not parse ${file}: ${e}`);
       continue;
@@ -457,10 +626,10 @@ function findCycles(graph) {
   }
   return unique;
 }
-function checkCircularImports(srcDir, basePackage) {
+async function checkCircularImports(srcDir, basePackage) {
   let stat;
   try {
-    stat = statSync(srcDir);
+    stat = statSync2(srcDir);
   } catch {
     console.error(`Error: ${srcDir}/ directory not found`);
     return 1;
@@ -469,7 +638,7 @@ function checkCircularImports(srcDir, basePackage) {
     console.error(`Error: ${srcDir}/ is not a directory`);
     return 1;
   }
-  const graph = buildDependencyGraph(srcDir, basePackage);
+  const graph = await buildDependencyGraph(srcDir, basePackage);
   console.log(`Scanned ${graph.size} modules`);
   const cycles = findCycles(graph);
   if (cycles.length > 0) {
@@ -532,5 +701,6 @@ export {
   loadCharset,
   loadConfig,
   resolveCharsets,
+  resolvePaths,
   version
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "apdev-js",
-  "version": "0.2.0",
-  "description": "Shared development tools for TypeScript/JavaScript projects - character validation, circular import detection, and more",
+  "version": "0.2.2",
+  "description": "General-purpose development tools for TypeScript/JavaScript projects - character validation, circular import detection, and more",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -31,9 +31,16 @@
   },
   "keywords": [
     "development-tools",
+    "quality-assurance",
+    "linting",
+    "static-analysis",
     "character-validation",
     "circular-imports",
-    "linting"
+    "release-automation",
+    "unicode-checker",
+    "trojan-source-detection",
+    "typescript",
+    "javascript"
   ],
   "author": "aipartnerup <tercel.yi@gmail.com>",
   "license": "Apache-2.0",
@@ -63,4 +70,4 @@
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   }
-}
+}