@nudojs/harvester 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# @nudojs/harvester
+
+## 0.2.0
+
+### Minor Changes
+
+- 5786fa5: Auto-inject `@types` during analysis-path harvest and guard oversized dts work.
+
+  - Analysis can resolve package roots upward and feed harvested Abs into the B module graph.
+  - `harvestDts` accepts optional `maxFileBytes` / `maxMs` and skips unreadable or oversized files instead of failing the run.
+
+### Patch Changes
+
+- Updated dependencies [5786fa5]
+- Updated dependencies [5786fa5]
+  - @nudojs/core@0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nudo Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -13,7 +13,10 @@ type HarvestedEnv = {
         skipped: number;
     };
 };
-declare function harvestDts(files: string[]): HarvestedEnv;
+declare function harvestDts(files: string[], opts?: {
+    maxFileBytes?: number;
+    maxMs?: number;
+}): HarvestedEnv;
 declare function emitEnvModule(env: HarvestedEnv, pkgName: string): string;
 
 export { type HarvestedEnv, emitEnvModule, harvestDts };

package/dist/index.js

@@ -1,12 +1,14 @@
 // src/index.ts
-import { readFileSync } from "fs";
+import { readFileSync, statSync } from "fs";
 import ts from "typescript";
 import { typeValueEquals, getFnSig, T } from "@nudojs/core";
 var MAX_ALIAS_DEPTH = 8;
 function scopeKey(scope) {
   return scope.moduleName ?? "\0global";
 }
-function harvestDts(files) {
+function harvestDts(files, opts) {
+  const maxBytes = opts?.maxFileBytes ?? 15e5;
+  const deadline = opts?.maxMs !== void 0 ? Date.now() + opts.maxMs : void 0;
   const ctx = {
     globals: {},
     modules: {},
@@ -24,16 +26,33 @@ function harvestDts(files) {
     symbols: 0,
     skipped: 0
   };
+  let parsed = 0;
   for (const file of files) {
-    const content = readFileSync(file, "utf8");
+    if (deadline !== void 0 && Date.now() > deadline) {
+      ctx.skipped += files.length - parsed;
+      break;
+    }
+    let content;
+    try {
+      const st = statSync(file);
+      if (st.size > maxBytes) {
+        ctx.skipped++;
+        continue;
+      }
+      content = readFileSync(file, "utf8");
+    } catch {
+      ctx.skipped++;
+      continue;
+    }
     const sourceFile = ts.createSourceFile(file, content, ts.ScriptTarget.Latest, true);
     collectStatements(ctx, sourceFile.statements, { moduleName: void 0, ns: [] });
+    parsed++;
   }
   materialize(ctx);
   return {
     globals: ctx.globals,
     modules: ctx.modules,
-    stats: { files: files.length, symbols: ctx.symbols, skipped: ctx.skipped }
+    stats: { files: parsed, symbols: ctx.symbols, skipped: ctx.skipped }
   };
 }
 function emitEnvModule(env, pkgName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nudojs/harvester",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Harvests TypeScript .d.ts declarations into Nudo env definitions",
   "type": "module",
   "license": "MIT",
@@ -18,11 +18,11 @@
     "provenance": true,
     "registry": "https://registry.npmjs.org"
   },
+  "dependencies": {
+    "typescript": "^5.8.0",
+    "@nudojs/core": "0.3.0"
+  },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts"
-  },
-  "dependencies": {
-    "@nudojs/core": "workspace:*",
-    "typescript": "^5.8.0"
   }
-}
+}

package/src/__tests__/generated-env.d.ts

@@ -0,0 +1,8 @@
+// harvest.test.ts 在运行时生成 generated-env.tmp.ts 并动态 import。
+// 类型检查期该文件不存在，用通配环境声明提供其形状（脚本文件，非模块增强）。
+declare module "*.tmp.ts" {
+  export function defineEnv(): {
+    globals: Record<string, unknown>;
+    modules: Record<string, Record<string, unknown>>;
+  };
+}

package/src/__tests__/harvest.test.ts

@@ -98,9 +98,7 @@ describe("emitEnvModule", () => {
   });
 
   it("emitted module evaluates and defines the env", { timeout: 120_000 }, async () => {
-    const mod = (await import("./generated-env.tmp.ts")) as {
-      defineEnv: () => { globals: Record<string, unknown>; modules: Record<string, Record<string, unknown>> };
-    };
+    const mod = await import("./generated-env.tmp.ts");
     const evaluated = mod.defineEnv();
     expect(evaluated.modules.fs).toBeDefined();
     expect(evaluated.modules["node:fs"].readFileSync).toBeDefined();

package/src/index.ts

@@ -1,4 +1,4 @@
-import { readFileSync } from "node:fs";
+import { readFileSync, statSync } from "node:fs";
 import ts from "typescript";
 import { type TypeValue, typeValueEquals, getFnSig, T } from "@nudojs/core";
 
@@ -68,7 +68,12 @@ function scopeKey(scope: Scope): string {
 // Public API
 // ---------------------------------------------------------------------------
 
-export function harvestDts(files: string[]): HarvestedEnv {
+export function harvestDts(
+  files: string[],
+  opts?: { maxFileBytes?: number; maxMs?: number },
+): HarvestedEnv {
+  const maxBytes = opts?.maxFileBytes ?? 1_500_000;
+  const deadline = opts?.maxMs !== undefined ? Date.now() + opts.maxMs : undefined;
   const ctx: HarvestContext = {
     globals: {},
     modules: {},
@@ -88,10 +93,27 @@ export function harvestDts(files: string[]): HarvestedEnv {
   };
 
   // Phase 1: collect declarations into the shared symbol table.
+  let parsed = 0;
   for (const file of files) {
-    const content = readFileSync(file, "utf8");
+    if (deadline !== undefined && Date.now() > deadline) {
+      ctx.skipped += files.length - parsed;
+      break;
+    }
+    let content: string;
+    try {
+      const st = statSync(file);
+      if (st.size > maxBytes) {
+        ctx.skipped++;
+        continue;
+      }
+      content = readFileSync(file, "utf8");
+    } catch {
+      ctx.skipped++;
+      continue;
+    }
     const sourceFile = ts.createSourceFile(file, content, ts.ScriptTarget.Latest, true);
     collectStatements(ctx, sourceFile.statements, { moduleName: undefined, ns: [] });
+    parsed++;
   }
 
   // Phase 2: materialize TypeValues with the complete symbol table available.
@@ -100,7 +122,7 @@ export function harvestDts(files: string[]): HarvestedEnv {
   return {
     globals: ctx.globals,
     modules: ctx.modules,
-    stats: { files: files.length, symbols: ctx.symbols, skipped: ctx.skipped },
+    stats: { files: parsed, symbols: ctx.symbols, skipped: ctx.skipped },
   };
 }