deslop-js 0.6.2 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -400,6 +400,16 @@ interface ScanResult {
400
400
  totalFiles: number;
401
401
  totalExports: number;
402
402
  analysisTimeMs: number;
403
+ /**
404
+ * Incremental-cache outcome for this run's per-file parse phase: how many
405
+ * collected files were served from cached summaries vs freshly parsed.
406
+ * Present only when `incrementalCachePath` was set and the cache loaded.
407
+ */
408
+ incrementalCacheStats?: IncrementalCacheStats;
409
+ }
410
+ interface IncrementalCacheStats {
411
+ summaryHits: number;
412
+ summaryMisses: number;
403
413
  }
404
414
  interface SemanticConfig {
405
415
  enabled: boolean;
@@ -418,6 +428,18 @@ interface DeslopConfig {
418
428
  includeExtensions: string[];
419
429
  tsConfigPath: string | undefined;
420
430
  paths: Record<string, string[]> | undefined;
431
+ /**
432
+ * Path of the on-disk incremental analysis cache (per-file parse summaries,
433
+ * the collected file list, the module-resolution map, and
434
+ * `detectStalePackages`' per-file package-reference facts; entry resolution
435
+ * always runs live). Unset (the default) means no caching — every run
436
+ * analyzes from scratch. The file is created on first use, validated
437
+ * stat-by-stat against the current tree on every run, and fails open on any
438
+ * corruption or version mismatch; results are byte-identical to an uncached
439
+ * run. Point it OUTSIDE the analyzed tree (e.g. `node_modules/.cache/...`)
440
+ * so its own writes don't churn the file fingerprint.
441
+ */
442
+ incrementalCachePath: string | undefined;
421
443
  reportTypes: boolean;
422
444
  includeEntryExports: boolean;
423
445
  reportRedundancy: boolean;
package/dist/index.d.mts CHANGED
@@ -400,6 +400,16 @@ interface ScanResult {
400
400
  totalFiles: number;
401
401
  totalExports: number;
402
402
  analysisTimeMs: number;
403
+ /**
404
+ * Incremental-cache outcome for this run's per-file parse phase: how many
405
+ * collected files were served from cached summaries vs freshly parsed.
406
+ * Present only when `incrementalCachePath` was set and the cache loaded.
407
+ */
408
+ incrementalCacheStats?: IncrementalCacheStats;
409
+ }
410
+ interface IncrementalCacheStats {
411
+ summaryHits: number;
412
+ summaryMisses: number;
403
413
  }
404
414
  interface SemanticConfig {
405
415
  enabled: boolean;
@@ -418,6 +428,18 @@ interface DeslopConfig {
418
428
  includeExtensions: string[];
419
429
  tsConfigPath: string | undefined;
420
430
  paths: Record<string, string[]> | undefined;
431
+ /**
432
+ * Path of the on-disk incremental analysis cache (per-file parse summaries,
433
+ * the collected file list, the module-resolution map, and
434
+ * `detectStalePackages`' per-file package-reference facts; entry resolution
435
+ * always runs live). Unset (the default) means no caching — every run
436
+ * analyzes from scratch. The file is created on first use, validated
437
+ * stat-by-stat against the current tree on every run, and fails open on any
438
+ * corruption or version mismatch; results are byte-identical to an uncached
439
+ * run. Point it OUTSIDE the analyzed tree (e.g. `node_modules/.cache/...`)
440
+ * so its own writes don't churn the file fingerprint.
441
+ */
442
+ incrementalCachePath: string | undefined;
421
443
  reportTypes: boolean;
422
444
  includeEntryExports: boolean;
423
445
  reportRedundancy: boolean;