apdev-js 0.1.0

package/dist/index.cjs

@@ -0,0 +1,550 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  buildDependencyGraph: () => buildDependencyGraph,
+  checkCircularImports: () => checkCircularImports,
+  checkFile: () => checkFile,
+  checkPaths: () => checkPaths,
+  fileToModule: () => fileToModule,
+  findCycles: () => findCycles,
+  isAllowedChar: () => isAllowedChar,
+  loadConfig: () => loadConfig,
+  version: () => version
+});
+module.exports = __toCommonJS(src_exports);
+
+// node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+// src/check-chars.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var EMOJI_RANGES = [
+  [127744, 128511],
+  // Symbols and Pictographs
+  [128512, 128591],
+  // Emoticons
+  [128640, 128767],
+  // Transport and Map Symbols
+  [128896, 129023],
+  // Geometric Shapes Extended
+  [129280, 129535],
+  // Supplemental Symbols and Pictographs
+  [9728, 9983],
+  // Miscellaneous Symbols
+  [9984, 10175]
+  // Dingbats
+];
+var EXTRA_ALLOWED_RANGES = [
+  [128, 255],
+  // Latin-1 Supplement
+  [8192, 8303],
+  // General Punctuation
+  [8448, 8527],
+  // Letterlike Symbols
+  [8592, 8703],
+  // Arrows
+  [8704, 8959],
+  // Mathematical Operators
+  [8960, 9215],
+  // Miscellaneous Technical
+  [9472, 9599],
+  // Box Drawing
+  [9632, 9727],
+  // Geometric Shapes
+  [11008, 11263],
+  // Miscellaneous Symbols and Arrows
+  [65024, 65039]
+  // Variation Selectors
+];
+var ALL_RANGES = [...EMOJI_RANGES, ...EXTRA_ALLOWED_RANGES];
+var DANGEROUS_CODEPOINTS = /* @__PURE__ */ new Map([
+  // Bidi control characters (Trojan Source - CVE-2021-42574)
+  [8234, "LEFT-TO-RIGHT EMBEDDING"],
+  [8235, "RIGHT-TO-LEFT EMBEDDING"],
+  [8236, "POP DIRECTIONAL FORMATTING"],
+  [8237, "LEFT-TO-RIGHT OVERRIDE"],
+  [8238, "RIGHT-TO-LEFT OVERRIDE"],
+  [8294, "LEFT-TO-RIGHT ISOLATE"],
+  [8295, "RIGHT-TO-LEFT ISOLATE"],
+  [8296, "FIRST STRONG ISOLATE"],
+  [8297, "POP DIRECTIONAL ISOLATE"],
+  // Zero-width characters
+  [8203, "ZERO WIDTH SPACE"],
+  [8204, "ZERO WIDTH NON-JOINER"],
+  [8205, "ZERO WIDTH JOINER"],
+  [8206, "LEFT-TO-RIGHT MARK"],
+  [8207, "RIGHT-TO-LEFT MARK"],
+  [8288, "WORD JOINER"]
+]);
+var PYTHON_SUFFIXES = /* @__PURE__ */ new Set([".py"]);
+var JS_SUFFIXES = /* @__PURE__ */ new Set([".js", ".ts", ".tsx", ".jsx", ".mjs", ".cjs"]);
+function isAllowedChar(c) {
+  const code = c.codePointAt(0);
+  if (code <= 127) {
+    return true;
+  }
+  for (const [start, end] of ALL_RANGES) {
+    if (code >= start && code <= end) {
+      return true;
+    }
+  }
+  return false;
+}
+function isDangerousChar(c) {
+  return DANGEROUS_CODEPOINTS.has(c.codePointAt(0));
+}
+function computeCommentMask(content, suffix) {
+  if (PYTHON_SUFFIXES.has(suffix)) {
+    return computeCommentMaskPython(content);
+  }
+  if (JS_SUFFIXES.has(suffix)) {
+    return computeCommentMaskJs(content);
+  }
+  return /* @__PURE__ */ new Set();
+}
+function computeCommentMaskPython(content) {
+  const mask = /* @__PURE__ */ new Set();
+  let i = 0;
+  const n = content.length;
+  while (i < n) {
+    if (i + 2 < n && (content.slice(i, i + 3) === '"""' || content.slice(i, i + 3) === "'''")) {
+      const quote = content.slice(i, i + 3);
+      i += 3;
+      while (i < n) {
+        if (content[i] === "\\" && i + 1 < n) {
+          i += 2;
+          continue;
+        }
+        if (i + 2 < n && content.slice(i, i + 3) === quote) {
+          i += 3;
+          break;
+        }
+        i++;
+      }
+      continue;
+    }
+    if (content[i] === '"' || content[i] === "'") {
+      const quoteChar = content[i];
+      i++;
+      while (i < n && content[i] !== "\n") {
+        if (content[i] === "\\" && i + 1 < n) {
+          i += 2;
+          continue;
+        }
+        if (content[i] === quoteChar) {
+          i++;
+          break;
+        }
+        i++;
+      }
+      continue;
+    }
+    if (content[i] === "#") {
+      while (i < n && content[i] !== "\n") {
+        mask.add(i);
+        i++;
+      }
+      continue;
+    }
+    i++;
+  }
+  return mask;
+}
+function computeCommentMaskJs(content) {
+  const mask = /* @__PURE__ */ new Set();
+  let i = 0;
+  const n = content.length;
+  while (i < n) {
+    if (content[i] === "`") {
+      i++;
+      while (i < n) {
+        if (content[i] === "\\" && i + 1 < n) {
+          i += 2;
+          continue;
+        }
+        if (content[i] === "`") {
+          i++;
+          break;
+        }
+        i++;
+      }
+      continue;
+    }
+    if (content[i] === '"' || content[i] === "'") {
+      const quoteChar = content[i];
+      i++;
+      while (i < n && content[i] !== "\n") {
+        if (content[i] === "\\" && i + 1 < n) {
+          i += 2;
+          continue;
+        }
+        if (content[i] === quoteChar) {
+          i++;
+          break;
+        }
+        i++;
+      }
+      continue;
+    }
+    if (i + 1 < n && content[i] === "/" && content[i + 1] === "/") {
+      while (i < n && content[i] !== "\n") {
+        mask.add(i);
+        i++;
+      }
+      continue;
+    }
+    if (i + 1 < n && content[i] === "/" && content[i + 1] === "*") {
+      while (i < n) {
+        if (i + 1 < n && content[i] === "*" && content[i + 1] === "/") {
+          mask.add(i);
+          mask.add(i + 1);
+          i += 2;
+          break;
+        }
+        mask.add(i);
+        i++;
+      }
+      continue;
+    }
+    i++;
+  }
+  return mask;
+}
+function checkFile(filePath, maxProblems = 5) {
+  const problems = [];
+  try {
+    const content = (0, import_node_fs.readFileSync)(filePath, "utf-8");
+    const suffix = (0, import_node_path.extname)(filePath).toLowerCase();
+    const commentMask = computeCommentMask(content, suffix);
+    let position = 0;
+    let offset = 0;
+    for (const char of content) {
+      position++;
+      const code = char.codePointAt(0);
+      if (isDangerousChar(char)) {
+        if (!commentMask.has(offset)) {
+          const name = DANGEROUS_CODEPOINTS.get(code);
+          const hex = code.toString(16).toUpperCase().padStart(4, "0");
+          problems.push(
+            `Dangerous character in code at position ${position}: U+${hex} (${name})`
+          );
+        }
+      } else if (!isAllowedChar(char)) {
+        const hex = code.toString(16).toUpperCase().padStart(4, "0");
+        problems.push(
+          `Illegal character at position ${position}: ${JSON.stringify(char)} (U+${hex})`
+        );
+      }
+      if (problems.length >= maxProblems) {
+        break;
+      }
+      offset += char.length;
+    }
+  } catch {
+    problems.push(`Failed to read file: ${filePath}`);
+  }
+  return problems;
+}
+function checkPaths(paths) {
+  let hasError = false;
+  for (const path of paths) {
+    const problems = checkFile(path);
+    if (problems.length > 0) {
+      hasError = true;
+      console.log(`
+${path} contains illegal characters:`);
+      for (const p of problems) {
+        console.log(`  ${p}`);
+      }
+    }
+  }
+  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 SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs"
+]);
+var INDEX_BASENAMES = /* @__PURE__ */ new Set([
+  "index.ts",
+  "index.tsx",
+  "index.js",
+  "index.jsx",
+  "index.mjs",
+  "index.cjs"
+]);
+function fileToModule(filePath, srcDir) {
+  const rel = (0, import_node_path2.relative)(srcDir, filePath);
+  const parts = rel.split(import_node_path2.sep);
+  const last = parts[parts.length - 1];
+  if (last === "index.ts" || last === "index.js" || last === "index.tsx" || last === "index.jsx") {
+    parts.pop();
+  } else {
+    const ext = (0, import_node_path2.extname)(last);
+    parts[parts.length - 1] = (0, import_node_path2.basename)(last, ext);
+  }
+  return parts.join(".");
+}
+function extractImports(source, fileName) {
+  const imports = /* @__PURE__ */ new Set();
+  const sourceFile = import_typescript.default.createSourceFile(
+    fileName,
+    source,
+    import_typescript.default.ScriptTarget.Latest,
+    true,
+    fileName.endsWith(".tsx") || fileName.endsWith(".jsx") ? import_typescript.default.ScriptKind.TSX : void 0
+  );
+  function visit(node) {
+    if (import_typescript.default.isImportDeclaration(node) && import_typescript.default.isStringLiteral(node.moduleSpecifier)) {
+      imports.add(node.moduleSpecifier.text);
+    }
+    if (import_typescript.default.isExportDeclaration(node) && node.moduleSpecifier && import_typescript.default.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])) {
+      imports.add(node.arguments[0].text);
+    }
+    import_typescript.default.forEachChild(node, visit);
+  }
+  visit(sourceFile);
+  return imports;
+}
+function resolveImports(rawImports, basePackage, currentModule, isPackage) {
+  const resolved = /* @__PURE__ */ new Set();
+  for (const imp of rawImports) {
+    if (imp.startsWith("./") || imp.startsWith("../")) {
+      if (!currentModule) continue;
+      const moduleParts = currentModule.split(".");
+      let dirParts;
+      if (isPackage) {
+        dirParts = [...moduleParts];
+      } else {
+        dirParts = moduleParts.slice(0, -1);
+      }
+      const segments = imp.split("/");
+      for (const seg of segments) {
+        if (seg === ".") continue;
+        if (seg === "..") {
+          dirParts.pop();
+        } else {
+          dirParts.push(seg);
+        }
+      }
+      const resolvedModule = dirParts.join(".");
+      if (resolvedModule === basePackage || resolvedModule.startsWith(basePackage + ".")) {
+        resolved.add(resolvedModule);
+      }
+    } else if (imp === basePackage || imp.startsWith(basePackage + "/")) {
+      resolved.add(imp.replaceAll("/", "."));
+    }
+  }
+  return resolved;
+}
+function findSourceFiles(dir) {
+  const results = [];
+  function walk(d) {
+    const entries = (0, import_node_fs2.readdirSync)(d);
+    for (const entry of entries) {
+      if (entry === "node_modules" || entry === "dist" || entry === ".git") {
+        continue;
+      }
+      const full = (0, import_node_path2.join)(d, entry);
+      const stat = (0, import_node_fs2.statSync)(full);
+      if (stat.isDirectory()) {
+        walk(full);
+      } else if (SUPPORTED_EXTENSIONS.has((0, import_node_path2.extname)(entry))) {
+        results.push(full);
+      }
+    }
+  }
+  walk(dir);
+  return results;
+}
+function buildDependencyGraph(srcDir, basePackage) {
+  const graph = /* @__PURE__ */ new Map();
+  const files = findSourceFiles(srcDir);
+  for (const file of files) {
+    const moduleName = fileToModule(file, srcDir);
+    if (!moduleName) continue;
+    let source;
+    try {
+      source = (0, import_node_fs2.readFileSync)(file, "utf-8");
+    } catch (e) {
+      console.error(`Warning: could not read ${file}: ${e}`);
+      continue;
+    }
+    let rawImports;
+    try {
+      rawImports = extractImports(source, file);
+    } catch (e) {
+      console.error(`Warning: could not parse ${file}: ${e}`);
+      continue;
+    }
+    const isPackage = INDEX_BASENAMES.has((0, import_node_path2.basename)(file));
+    const deps = resolveImports(rawImports, basePackage, moduleName, isPackage);
+    deps.delete(moduleName);
+    graph.set(moduleName, deps);
+  }
+  return graph;
+}
+function findCycles(graph) {
+  const WHITE = 0;
+  const GRAY = 1;
+  const BLACK = 2;
+  const color = /* @__PURE__ */ new Map();
+  const path = [];
+  const cycles = [];
+  function dfs(node) {
+    color.set(node, GRAY);
+    path.push(node);
+    const neighbors = graph.get(node) ?? /* @__PURE__ */ new Set();
+    for (const neighbor of [...neighbors].sort()) {
+      if (color.get(neighbor) === GRAY && path.includes(neighbor)) {
+        const idx = path.indexOf(neighbor);
+        cycles.push([...path.slice(idx), neighbor]);
+      } else if ((color.get(neighbor) ?? WHITE) === WHITE) {
+        dfs(neighbor);
+      }
+    }
+    path.pop();
+    color.set(node, BLACK);
+  }
+  for (const node of [...graph.keys()].sort()) {
+    if ((color.get(node) ?? WHITE) === WHITE) {
+      dfs(node);
+    }
+  }
+  const unique = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const cycle of cycles) {
+    const ring = cycle.slice(0, -1);
+    let minVal = ring[0];
+    let minIdx = 0;
+    for (let i = 1; i < ring.length; i++) {
+      if (ring[i] < minVal) {
+        minVal = ring[i];
+        minIdx = i;
+      }
+    }
+    const normalized = [...ring.slice(minIdx), ...ring.slice(0, minIdx)].join(",");
+    if (!seen.has(normalized)) {
+      seen.add(normalized);
+      unique.push(cycle);
+    }
+  }
+  return unique;
+}
+function checkCircularImports(srcDir, basePackage) {
+  let stat;
+  try {
+    stat = (0, import_node_fs2.statSync)(srcDir);
+  } catch {
+    console.error(`Error: ${srcDir}/ directory not found`);
+    return 1;
+  }
+  if (!stat.isDirectory()) {
+    console.error(`Error: ${srcDir}/ is not a directory`);
+    return 1;
+  }
+  const graph = buildDependencyGraph(srcDir, basePackage);
+  console.log(`Scanned ${graph.size} modules`);
+  const cycles = findCycles(graph);
+  if (cycles.length > 0) {
+    console.log(`
+Found ${cycles.length} circular import(s):
+`);
+    for (let i = 0; i < cycles.length; i++) {
+      console.log(`  Cycle ${i + 1}: ${cycles[i].join(" -> ")}`);
+    }
+    console.log();
+    return 1;
+  }
+  console.log("No circular imports detected.");
+  return 0;
+}
+
+// src/config.ts
+var import_node_fs3 = require("fs");
+var import_node_path3 = require("path");
+function loadConfig(projectDir) {
+  const dir = projectDir ?? process.cwd();
+  const pkgPath = (0, import_node_path3.join)(dir, "package.json");
+  let raw;
+  try {
+    raw = (0, import_node_fs3.readFileSync)(pkgPath, "utf-8");
+  } catch {
+    return {};
+  }
+  const pkg = JSON.parse(raw);
+  const apdev = pkg["apdev"];
+  if (apdev && typeof apdev === "object" && !Array.isArray(apdev)) {
+    return apdev;
+  }
+  return {};
+}
+
+// src/index.ts
+var import_node_fs4 = require("fs");
+var import_node_path4 = require("path");
+var import_node_url = require("url");
+function readVersion() {
+  const thisDir = typeof __dirname !== "undefined" ? __dirname : (0, import_node_path4.dirname)((0, import_node_url.fileURLToPath)(importMetaUrl));
+  try {
+    const pkg = JSON.parse((0, import_node_fs4.readFileSync)((0, import_node_path4.join)(thisDir, "..", "package.json"), "utf-8"));
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+var version = readVersion();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildDependencyGraph,
+  checkCircularImports,
+  checkFile,
+  checkPaths,
+  fileToModule,
+  findCycles,
+  isAllowedChar,
+  loadConfig,
+  version
+});

package/dist/index.d.cts

@@ -0,0 +1,41 @@
+/** Return true if the character is in the allowed set. */
+declare function isAllowedChar(c: string): boolean;
+/**
+ * Check a single file for illegal characters.
+ * Returns a list of problem descriptions (empty if the file is clean).
+ */
+declare function checkFile(filePath: string, maxProblems?: number): string[];
+/**
+ * Check multiple files. Returns 0 if all clean, 1 if any have problems.
+ */
+declare function checkPaths(paths: string[]): number;
+
+/**
+ * Circular import detection tool.
+ *
+ * Builds a module-level dependency graph within a JS/TS package
+ * and reports any circular import chains.
+ */
+/** 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>>;
+/** 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;
+
+/**
+ * Configuration loading for apdev.
+ *
+ * Reads the "apdev" field from the consumer project's package.json.
+ */
+declare function loadConfig(projectDir?: string): Record<string, unknown>;
+
+/**
+ * apdev - Shared development tools for TypeScript/JavaScript projects.
+ */
+
+declare const version: string;
+
+export { buildDependencyGraph, checkCircularImports, checkFile, checkPaths, fileToModule, findCycles, isAllowedChar, loadConfig, version };

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/** Return true if the character is in the allowed set. */
+declare function isAllowedChar(c: string): boolean;
+/**
+ * Check a single file for illegal characters.
+ * Returns a list of problem descriptions (empty if the file is clean).
+ */
+declare function checkFile(filePath: string, maxProblems?: number): string[];
+/**
+ * Check multiple files. Returns 0 if all clean, 1 if any have problems.
+ */
+declare function checkPaths(paths: string[]): number;
+
+/**
+ * Circular import detection tool.
+ *
+ * Builds a module-level dependency graph within a JS/TS package
+ * and reports any circular import chains.
+ */
+/** 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>>;
+/** 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;
+
+/**
+ * Configuration loading for apdev.
+ *
+ * Reads the "apdev" field from the consumer project's package.json.
+ */
+declare function loadConfig(projectDir?: string): Record<string, unknown>;
+
+/**
+ * apdev - Shared development tools for TypeScript/JavaScript projects.
+ */
+
+declare const version: string;
+
+export { buildDependencyGraph, checkCircularImports, checkFile, checkPaths, fileToModule, findCycles, isAllowedChar, loadConfig, version };