@repo-map/core 0.1.0

package/dist/entry-detector.d.ts

@@ -0,0 +1,20 @@
+import type { ModuleInfo } from "./module-detector.js";
+export type EntryType = "web-route" | "controller" | "service" | "cli-entry" | "job" | "worker" | "unknown-entry";
+export interface EntryInfo {
+    path: string;
+    type: EntryType;
+}
+export interface ModuleEntries {
+    path: string;
+    entries: EntryInfo[];
+}
+export interface EntryMap {
+    modules: ModuleEntries[];
+}
+export interface EntryDetectorOptions {
+    files: Iterable<string>;
+    modules: ModuleInfo[];
+    includeUnknown?: boolean;
+    maxEntriesPerModule?: number;
+}
+export declare const detectEntries: (options: EntryDetectorOptions) => EntryMap;

package/dist/entry-detector.js

@@ -0,0 +1,192 @@
+import path from "node:path";
+const CODE_EXTENSIONS = new Set([
+    ".js",
+    ".jsx",
+    ".ts",
+    ".tsx",
+    ".mjs",
+    ".cjs",
+    ".mts",
+    ".cts",
+    ".py",
+    ".go"
+]);
+const WEB_ROUTE_SEGMENTS = new Set([
+    "routes",
+    "route",
+    "router",
+    "routing",
+    "routers",
+    "endpoints",
+    "endpoint",
+    "pages",
+    "api"
+]);
+const CONTROLLER_SEGMENTS = new Set(["controller", "controllers"]);
+const SERVICE_SEGMENTS = new Set(["service", "services"]);
+const CLI_SEGMENTS = new Set(["cli", "bin", "cmd", "command", "commands"]);
+const WORKER_SEGMENTS = new Set(["worker", "workers", "queue", "queues"]);
+const JOB_SEGMENTS = new Set(["job", "jobs", "cron", "scheduler", "schedule", "task", "tasks"]);
+const TEST_SEGMENTS = new Set([
+    "test",
+    "tests",
+    "__tests__",
+    "spec",
+    "specs",
+    "__specs__",
+    "fixture",
+    "fixtures",
+    "mock",
+    "mocks",
+    "__mocks__"
+]);
+const ENTRY_TYPE_ORDER = [
+    "web-route",
+    "controller",
+    "service",
+    "cli-entry",
+    "worker",
+    "job",
+    "unknown-entry"
+];
+const ENTRY_TYPE_RANK = new Map(ENTRY_TYPE_ORDER.map((type, index) => [type, index]));
+const normalizePosixPath = (value) => {
+    let normalized = value.replace(/\\/g, "/").trim();
+    if (normalized.startsWith("./"))
+        normalized = normalized.slice(2);
+    while (normalized.endsWith("/") && normalized.length > 1) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized.length === 0 ? "." : normalized;
+};
+const compareNames = (left, right) => {
+    if (left === right)
+        return 0;
+    return left < right ? -1 : 1;
+};
+const resolveModuleRoot = (filePath, moduleRoots, cache) => {
+    let dir = path.posix.dirname(filePath);
+    if (dir === ".")
+        dir = ".";
+    const visited = [];
+    while (true) {
+        const cached = cache.get(dir);
+        if (cached) {
+            for (const entry of visited)
+                cache.set(entry, cached);
+            return cached;
+        }
+        visited.push(dir);
+        if (moduleRoots.has(dir)) {
+            for (const entry of visited)
+                cache.set(entry, dir);
+            return dir;
+        }
+        if (dir === ".") {
+            for (const entry of visited)
+                cache.set(entry, ".");
+            return ".";
+        }
+        dir = path.posix.dirname(dir);
+    }
+};
+const hasSegment = (segments, set) => segments.some((segment) => set.has(segment));
+const isTestFile = (segments, baseName) => {
+    if (hasSegment(segments, TEST_SEGMENTS))
+        return true;
+    return baseName.includes(".test") || baseName.includes(".spec");
+};
+const detectEntryType = (filePath) => {
+    const ext = path.posix.extname(filePath);
+    if (!CODE_EXTENSIONS.has(ext))
+        return null;
+    const segments = filePath
+        .split("/")
+        .filter(Boolean)
+        .map((segment) => segment.toLowerCase());
+    const baseName = path.posix.basename(filePath, ext).toLowerCase();
+    if (isTestFile(segments, baseName))
+        return null;
+    const baseHas = (needle) => baseName.includes(needle);
+    const webRouteMatch = hasSegment(segments, WEB_ROUTE_SEGMENTS) ||
+        baseHas("route") ||
+        baseHas("router") ||
+        baseHas("routing");
+    if (webRouteMatch)
+        return "web-route";
+    const controllerMatch = hasSegment(segments, CONTROLLER_SEGMENTS) || baseHas("controller");
+    if (controllerMatch)
+        return "controller";
+    const serviceMatch = hasSegment(segments, SERVICE_SEGMENTS) || baseHas("service");
+    if (serviceMatch)
+        return "service";
+    const cliMatch = hasSegment(segments, CLI_SEGMENTS) ||
+        baseHas("cli") ||
+        baseName === "main";
+    if (cliMatch)
+        return "cli-entry";
+    const workerMatch = hasSegment(segments, WORKER_SEGMENTS) || baseHas("worker") || baseHas("queue");
+    if (workerMatch)
+        return "worker";
+    const jobMatch = hasSegment(segments, JOB_SEGMENTS) || baseHas("job") || baseHas("cron");
+    if (jobMatch)
+        return "job";
+    return null;
+};
+const addEntry = (map, entryKeys, modulePath, entry, maxEntriesPerModule) => {
+    const entries = map.get(modulePath) ?? [];
+    if (entries.length >= maxEntriesPerModule)
+        return;
+    const keySet = entryKeys.get(modulePath) ?? new Set();
+    const key = `${entry.type}:${entry.path}`;
+    if (keySet.has(key))
+        return;
+    entries.push(entry);
+    keySet.add(key);
+    map.set(modulePath, entries);
+    entryKeys.set(modulePath, keySet);
+};
+export const detectEntries = (options) => {
+    const includeUnknown = options.includeUnknown ?? true;
+    const maxEntriesPerModule = options.maxEntriesPerModule ?? 200;
+    const files = Array.isArray(options.files)
+        ? options.files.map(normalizePosixPath)
+        : Array.from(options.files, normalizePosixPath);
+    const moduleRoots = new Set(options.modules.map((module) => normalizePosixPath(module.path)));
+    if (!moduleRoots.has("."))
+        moduleRoots.add(".");
+    const moduleMap = new Map();
+    const entryKeys = new Map();
+    const dirCache = new Map();
+    for (const filePath of files) {
+        if (!filePath || filePath === ".")
+            continue;
+        const entryType = detectEntryType(filePath);
+        if (!entryType)
+            continue;
+        const moduleRoot = resolveModuleRoot(filePath, moduleRoots, dirCache);
+        addEntry(moduleMap, entryKeys, moduleRoot, { path: filePath, type: entryType }, maxEntriesPerModule);
+    }
+    const modules = Array.from(moduleRoots).sort(compareNames);
+    const entries = [];
+    for (const modulePath of modules) {
+        const moduleEntries = moduleMap.get(modulePath) ?? [];
+        moduleEntries.sort((a, b) => {
+            const rankA = ENTRY_TYPE_RANK.get(a.type) ?? 999;
+            const rankB = ENTRY_TYPE_RANK.get(b.type) ?? 999;
+            if (rankA !== rankB)
+                return rankA - rankB;
+            return compareNames(a.path, b.path);
+        });
+        if (moduleEntries.length === 0 && includeUnknown) {
+            entries.push({
+                path: modulePath,
+                entries: [{ path: "", type: "unknown-entry" }]
+            });
+            continue;
+        }
+        entries.push({ path: modulePath, entries: moduleEntries });
+    }
+    return { modules: entries };
+};
+//# sourceMappingURL=entry-detector.js.map

package/dist/entry-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-detector.js","sourceRoot":"","sources":["../src/entry-detector.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAiC7B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,SAAS;IACT,WAAW;IACX,UAAU;IACV,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AACnE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAC1D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAC3E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhG,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,OAAO;IACP,WAAW;IACX,MAAM;IACN,OAAO;IACP,WAAW;IACX,SAAS;IACT,UAAU;IACV,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAgB;IACpC,WAAW;IACX,YAAY;IACZ,SAAS;IACT,WAAW;IACX,QAAQ;IACR,KAAK;IACL,eAAe;CAChB,CAAC;AAEF,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CACrD,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,EAAE;IAC3C,IAAI,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AACpD,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;IACnD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,QAAgB,EAChB,WAAwB,EACxB,KAA0B,EAC1B,EAAE;IACF,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,GAAG,KAAK,GAAG;QAAE,GAAG,GAAG,GAAG,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,KAAK,IAAI,OAAO;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,KAAK,IAAI,OAAO;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAChB,KAAK,MAAM,KAAK,IAAI,OAAO;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,QAAkB,EAAE,GAAgB,EAAE,EAAE,CAC1D,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAE/C,MAAM,UAAU,GAAG,CAAC,QAAkB,EAAE,QAAgB,EAAE,EAAE;IAC1D,IAAI,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAoB,EAAE;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,QAAQ,GAAG,QAAQ;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAElE,IAAI,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9D,MAAM,aAAa,GACjB,UAAU,CAAC,QAAQ,EAAE,kBAAkB,CAAC;QACxC,OAAO,CAAC,OAAO,CAAC;QAChB,OAAO,CAAC,QAAQ,CAAC;QACjB,OAAO,CAAC,SAAS,CAAC,CAAC;IACrB,IAAI,aAAa;QAAE,OAAO,WAAW,CAAC;IAEtC,MAAM,eAAe,GACnB,UAAU,CAAC,QAAQ,EAAE,mBAAmB,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACrE,IAAI,eAAe;QAAE,OAAO,YAAY,CAAC;IAEzC,MAAM,YAAY,GAChB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,YAAY;QAAE,OAAO,SAAS,CAAC;IAEnC,MAAM,QAAQ,GACZ,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC;QACd,QAAQ,KAAK,MAAM,CAAC;IACtB,IAAI,QAAQ;QAAE,OAAO,WAAW,CAAC;IAEjC,MAAM,WAAW,GACf,UAAU,CAAC,QAAQ,EAAE,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,IAAI,WAAW;QAAE,OAAO,QAAQ,CAAC;IAEjC,MAAM,QAAQ,GACZ,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE3B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CACf,GAA6B,EAC7B,SAAmC,EACnC,UAAkB,EAClB,KAAgB,EAChB,mBAA2B,EAC3B,EAAE;IACF,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,IAAI,mBAAmB;QAAE,OAAO;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;IAC9D,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAA6B,EACnB,EAAE;IACZ,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,GAAG,CAAC;IAE/D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACvC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAElD,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CACjE,CAAC;IACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,GAAG;YAAE,SAAS;QAC5C,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtE,QAAQ,CACN,SAAS,EACT,SAAS,EACT,UAAU,EACV,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,EACnC,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACtD,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACjD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACjD,IAAI,KAAK,KAAK,KAAK;gBAAE,OAAO,KAAK,GAAG,KAAK,CAAC;YAC1C,OAAO,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;aAC/C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC,CAAC"}

package/dist/file-index.d.ts

@@ -0,0 +1,27 @@
+import type { HashAlgorithm } from "./meta.js";
+export interface FileIndexEntry {
+    path: string;
+    size: number;
+    mtimeMs: number;
+    hash: string | null;
+}
+export interface FileIndex {
+    repoRoot: string;
+    hashAlgorithm: HashAlgorithm;
+    files: FileIndexEntry[];
+}
+export interface FileChangeSet {
+    hashAlgorithm: HashAlgorithm;
+    added: string[];
+    modified: string[];
+    deleted: string[];
+}
+export interface BuildFileIndexOptions {
+    repoRoot: string;
+    files: Iterable<string>;
+    hashAlgorithm?: HashAlgorithm;
+    concurrency?: number;
+    onError?: (err: NodeJS.ErrnoException, path: string) => void;
+}
+export declare const buildFileIndex: (options: BuildFileIndexOptions) => Promise<FileIndex>;
+export declare const diffFileIndex: (previous: FileIndex, current: FileIndex) => FileChangeSet;

package/dist/file-index.js

@@ -0,0 +1,132 @@
+import path from "node:path";
+import * as fs from "node:fs/promises";
+import { createReadStream } from "node:fs";
+import { createHash } from "node:crypto";
+const DEFAULT_CONCURRENCY = 8;
+const compareNames = (left, right) => {
+    if (left === right)
+        return 0;
+    return left < right ? -1 : 1;
+};
+const normalizePosixPath = (value) => {
+    let normalized = value.replace(/\\/g, "/").trim();
+    if (normalized.startsWith("./"))
+        normalized = normalized.slice(2);
+    while (normalized.endsWith("/") && normalized.length > 1) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized.length === 0 ? "." : normalized;
+};
+const reportError = (err, targetPath, onError) => {
+    if (!onError)
+        return;
+    const error = err;
+    if (error?.code === "ENOENT")
+        return;
+    onError(error, targetPath);
+};
+const resolveAbsPath = (repoRoot, filePath) => {
+    const segments = filePath === "." ? [] : filePath.split("/");
+    return path.resolve(repoRoot, ...segments);
+};
+const hashFile = (absPath, algorithm, onError) => new Promise((resolve) => {
+    const hash = createHash(algorithm);
+    const stream = createReadStream(absPath);
+    stream.on("data", (chunk) => hash.update(chunk));
+    stream.on("error", (err) => {
+        reportError(err, absPath, onError);
+        resolve(null);
+    });
+    stream.on("end", () => {
+        resolve(hash.digest("hex"));
+    });
+});
+const buildEntry = async (repoRoot, filePath, algorithm, onError) => {
+    const absPath = resolveAbsPath(repoRoot, filePath);
+    try {
+        const stats = await fs.stat(absPath);
+        const hash = await hashFile(absPath, algorithm, onError);
+        return {
+            path: filePath,
+            size: stats.size,
+            mtimeMs: stats.mtimeMs,
+            hash
+        };
+    }
+    catch (err) {
+        reportError(err, absPath, onError);
+        return null;
+    }
+};
+export const buildFileIndex = async (options) => {
+    const repoRoot = path.resolve(options.repoRoot);
+    const hashAlgorithm = options.hashAlgorithm ?? "sha256";
+    const concurrency = Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY);
+    const files = Array.isArray(options.files)
+        ? options.files.map(normalizePosixPath)
+        : Array.from(options.files, normalizePosixPath);
+    const onError = options.onError;
+    const entries = [];
+    let index = 0;
+    const worker = async () => {
+        while (true) {
+            const current = index;
+            index += 1;
+            if (current >= files.length)
+                break;
+            const filePath = files[current];
+            if (!filePath || filePath === ".")
+                continue;
+            const entry = await buildEntry(repoRoot, filePath, hashAlgorithm, onError);
+            if (entry)
+                entries.push(entry);
+        }
+    };
+    const workers = Array.from({ length: Math.min(concurrency, files.length) }, () => worker());
+    await Promise.all(workers);
+    entries.sort((a, b) => compareNames(a.path, b.path));
+    return {
+        repoRoot,
+        hashAlgorithm,
+        files: entries
+    };
+};
+const entryChanged = (prev, next, useHash) => {
+    if (useHash && prev.hash && next.hash) {
+        return prev.hash !== next.hash;
+    }
+    return prev.size !== next.size || prev.mtimeMs !== next.mtimeMs;
+};
+export const diffFileIndex = (previous, current) => {
+    const prevMap = new Map(previous.files.map((entry) => [entry.path, entry]));
+    const nextMap = new Map(current.files.map((entry) => [entry.path, entry]));
+    const useHash = previous.hashAlgorithm === current.hashAlgorithm;
+    const added = [];
+    const modified = [];
+    const deleted = [];
+    for (const entry of current.files) {
+        const prevEntry = prevMap.get(entry.path);
+        if (!prevEntry) {
+            added.push(entry.path);
+            continue;
+        }
+        if (entryChanged(prevEntry, entry, useHash)) {
+            modified.push(entry.path);
+        }
+    }
+    for (const entry of previous.files) {
+        if (!nextMap.has(entry.path)) {
+            deleted.push(entry.path);
+        }
+    }
+    added.sort(compareNames);
+    modified.sort(compareNames);
+    deleted.sort(compareNames);
+    return {
+        hashAlgorithm: current.hashAlgorithm,
+        added,
+        modified,
+        deleted
+    };
+};
+//# sourceMappingURL=file-index.js.map

package/dist/file-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-index.js","sourceRoot":"","sources":["../src/file-index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./meta.js";
+export * from "./walker.js";
+export * from "./module-detector.js";
+export * from "./keyword-extractor.js";
+export * from "./module-index.js";
+export * from "./entry-detector.js";
+export * from "./summary.js";
+export * from "./file-index.js";
+export * from "./query.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from "./meta.js";
+export * from "./walker.js";
+export * from "./module-detector.js";
+export * from "./keyword-extractor.js";
+export * from "./module-index.js";
+export * from "./entry-detector.js";
+export * from "./summary.js";
+export * from "./file-index.js";
+export * from "./query.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/keyword-extractor.d.ts

@@ -0,0 +1,21 @@
+import type { ModuleInfo } from "./module-detector.js";
+export interface ModuleKeywords {
+    path: string;
+    keywords: string[];
+}
+export interface KeywordExtractorOptions {
+    repoRoot: string;
+    files: Iterable<string>;
+    modules: ModuleInfo[];
+    includeModules?: string[] | Set<string>;
+    minKeywords?: number;
+    maxKeywords?: number;
+    maxContentBytes?: number;
+    maxContentFiles?: number;
+    includeFileNames?: boolean;
+    includeExports?: boolean;
+    includeRoutes?: boolean;
+    includeInterfaces?: boolean;
+    onError?: (err: NodeJS.ErrnoException, path: string) => void;
+}
+export declare function extractModuleKeywords(options: KeywordExtractorOptions): Promise<ModuleKeywords[]>;