vitest-auto-spy 4.2.0 → 4.3.0

package/dist/cli.js

@@ -187,13 +187,14 @@ function stripJsonComments(text) {
   return result.replace(/,(\s*[\]}])/g, "$1");
 }
 function findStringEnd(text, start) {
+  const quote = text[start];
   let index = start + 1;
   while (index < text.length) {
     if (text[index] === "\\") {
       index += 2;
       continue;
     }
-    if (text[index] === '"') {
+    if (text[index] === quote) {
       return index + 1;
     }
     index += 1;
@@ -643,12 +644,12 @@ function insertIntoBraces(source, host, needs) {
   return { start: last, end: last, text: /,$/.test(source.slice(open + 1, last)) ? ` ${addition}` : `, ${addition}` };
 }
 function pickHost(statements, specifier, needs) {
-  const candidates = hostsFor(statements, specifier);
-  const value = candidates.find((host) => !host.statement.typeOnly);
+  const candidates2 = hostsFor(statements, specifier);
+  const value = candidates2.find((host) => !host.statement.typeOnly);
   if (value !== void 0) {
     return value;
   }
-  return needs.every((need) => need.typeOnly) ? candidates[0] : void 0;
+  return needs.every((need) => need.typeOnly) ? candidates2[0] : void 0;
 }
 function uniqueNeeds(source, statements, needs) {
   const bound = allBound(source, statements);
@@ -1076,8 +1077,8 @@ function best(pool) {
 function partsOf(specifier) {
   return specifier.slice(specifier.indexOf("/") + 1).split("-");
 }
-function narrow(candidates, framework) {
-  return framework === void 0 ? [] : candidates.filter((candidate) => partsOf(candidate).includes(framework));
+function narrow(candidates2, framework) {
+  return framework === void 0 ? [] : candidates2.filter((candidate) => partsOf(candidate).includes(framework));
 }
 function sameRuntime(pool, preferred) {
   const wanted = pool.filter((candidate) => candidate.startsWith(BUN_PREFIX) === preferred.startsWith(BUN_PREFIX));
@@ -1096,16 +1097,16 @@ function chooseEntry(map, name, preferred, hint) {
   }
   return specifiers.length === 1 ? { kind: "chosen", entry: best(specifiers) } : decide(specifiers, preferred, hint);
 }
-function decide(candidates, preferred, hint) {
-  const known = candidates.find((candidate) => hint.imported.includes(candidate));
+function decide(candidates2, preferred, hint) {
+  const known = candidates2.find((candidate) => hint.imported.includes(candidate));
   if (known !== void 0) {
     return { kind: "chosen", entry: known };
   }
-  const scoped = narrow(candidates, hint.framework);
+  const scoped = narrow(candidates2, hint.framework);
   if (scoped.length > 0) {
     return { kind: "chosen", entry: best(sameRuntime(scoped, preferred)) };
   }
-  return { kind: "guessed", entry: best(sameRuntime(candidates, preferred)), candidates };
+  return { kind: "guessed", entry: best(sameRuntime(candidates2, preferred)), candidates: candidates2 };
 }
 function entryFor(map, name, preferred) {
   const choice = chooseEntry(map, name, preferred, NO_HINT);
@@ -2353,6 +2354,521 @@ function checkForeignPragma(graph) {
   }
   return findings;
 }
+
+// src/cli/checks/export-map.generated.ts
+var EXPORT_MAP_VERSION = "4.2.0";
+var ENTRY_SPECIFIERS = "vitest-auto-spy vitest-auto-spy/bun vitest-auto-spy/bun-angular vitest-auto-spy/node vitest-auto-spy/rxjs vitest-auto-spy/console vitest-auto-spy/dom-stubs vitest-auto-spy/diagnostics vitest-auto-spy/jasmine vitest-auto-spy/jasmine-compat vitest-auto-spy/observer-spy vitest-auto-spy/angular vitest-auto-spy/angular-http vitest-auto-spy/nestjs vitest-auto-spy/react vitest-auto-spy/vue vitest-auto-spy/svelte vitest-auto-spy/setup vitest-auto-spy/zone vitest-auto-spy/eslint-plugin";
+var EXPORTED_BY = {
+  AccessorImplementations: "0 1 2 3 11 14 15 16",
+  AccessorKeysOf: "0 1 2 3 14 15 16",
+  AddAccessorsSpies: "0 1 2 3 14 15 16",
+  AddCalledWithObservable: "0 1 2 3 14 15 16",
+  AddCalledWithPromise: "0 1 2 3 14 15 16",
+  AddCalledWithSpyMethods: "0 1 2 3 14 15 16",
+  AddObservableSpyMethods: "0 1 2 3 4 14 15 16",
+  AddPromiseSpyMethods: "0 1 2 3 14 15 16",
+  AddSpyMethodsByReturnTypes: "0 1 2 3 14 15 16",
+  AddThrowHelper: "0 1 2 3 14 15 16",
+  AddVoidReturnHelpers: "0 1 2 3 14 15 16",
+  advanceTimers: "17",
+  AngularDiagnosticsOptions: "11",
+  AngularResourceInlinerOptions: "2",
+  AngularTestEnvMode: "11",
+  AngularTestEnvOptions: "11",
+  AngularTokenProvider: "11",
+  AngularValueProvider: "2 8 11",
+  ArgCaptor: "0 1 2 3 14 15 16",
+  asInstance: "0 1 2 3 14 15 16",
+  asInstances: "0 1 2 3 14 15 16",
+  AsInstances: "0 1 2 3 14 15 16",
+  assertComponentDefIntact: "11",
+  assertMocked: "0 1 2 3 14 15 16",
+  AssertMockedOptions: "0 1 2 3 14 15 16",
+  assertNgModuleScopes: "11",
+  assertNoPendingRequests: "11",
+  asSpy: "0 1 2 3 14 15 16",
+  AutoMockConfiguration: "0 1 2 3 14 15 16",
+  autoMocked: "0 1 2 3 14 15 16",
+  AutoSpiedInstance: "2 11",
+  AutoSpyEslintPlugin: "19",
+  AutoSpyFixture: "11",
+  AutoSpyOverride: "11",
+  AutoSpyRxjsTypes: "0 1 2 3 14 15 16",
+  BLOCKED_FETCH_MESSAGE: "17",
+  BLOCKED_XHR_MESSAGE: "17",
+  blockNetwork: "17",
+  BlockNetworkOptions: "17",
+  CallbackSubscribable: "0 1 2 3 11 14 15 16",
+  cancelStrayTimers: "17",
+  captureArg: "0 1 2 3 14 15 16",
+  captureMockRegistry: "17",
+  ClassSpyConfiguration: "0 1 2 3 8 14 15 16",
+  ClassType: "0 1 2 3 8 14 15 16",
+  clearAutoSpy: "0 1 2 3 14 15 16",
+  compareTestRuns: "7",
+  CompleteValueConfig: "0 1 2 3 4 14 15 16",
+  ComponentInputs: "2 11",
+  consoleDebugSpy: "5",
+  consoleErrorSpy: "5",
+  consoleInfoSpy: "5",
+  consoleLogSpy: "5",
+  ConsoleMethodSpy: "5",
+  ConsoleSpies: "5",
+  consoleTimeEndSpy: "5",
+  consoleTimeSpy: "5",
+  consoleTraceSpy: "5",
+  consoleWarnSpy: "5",
+  ConstructorMock: "0 1 2 3 14 15 16",
+  ConstructorSpy: "0 1 2 3 14 15 16",
+  copyWindowGlobals: "2",
+  CountingClock: "17",
+  CountingClockOptions: "17",
+  countMockedProps: "0 1 2 3 11 14 15 16",
+  countNodeMocks: "3",
+  countStrayRejections: "17",
+  countStrayTimers: "17",
+  createAutoMock: "0 1 2 3 14 15 16",
+  createDirectiveHost: "11",
+  createFixture: "0 1 2 3 14 15 16",
+  createFixtureFactory: "0 1 2 3 14 15 16",
+  createFunctionSpy: "0 1 2 3 8 14 15 16",
+  createGlobalRegistratorRegistrar: "2",
+  createJsdomRegistrar: "2",
+  createMock: "0 1 2 3 14 15 16",
+  createNestUnit: "13",
+  CreateNestUnitOptions: "13",
+  createObservableWithValues: "4",
+  createSpyClass: "0 1 2 3 14 15 16",
+  createSpyFromClass: "0 1 2 3 8 14 15 16",
+  createSpyFromInstance: "0 1 2 3 14 15 16",
+  createSpyObj: "8",
+  createWithAutoSpies: "2 11",
+  CreateWithAutoSpiesOptions: "2 11",
+  DeepMockProxy: "0 1 2 3 14 15 16",
+  DeepPartial: "0 1 2 3 14 15 16",
+  default: "19",
+  describeDuplicateCopies: "0 1 2 3 14 15 16 17",
+  diffByField: "7",
+  DirectiveHostOptions: "11",
+  disableAngularDiagnostics: "11",
+  disableTestBedDiagnostics: "11",
+  DomRegistrar: "2",
+  DuplicateCopiesReaction: "17",
+  EmissionObserver: "0 1 2 3 11 14 15 16",
+  EmissionOptions: "0 1 2 3 11 14 15 16",
+  EmissionSource: "0 1 2 3 11 14 15 16",
+  enableAngularDiagnostics: "11",
+  enableJasmineCompat: "8 9",
+  enableTestBedDiagnostics: "11",
+  errorHandler: "0 1 2 3 14 15 16",
+  ErrorValueConfig: "0 1 2 3 4 14 15 16",
+  expectCompletion: "0 1 2 3 11 14 15 16",
+  expectEmission: "0 1 2 3 11 14 15 16",
+  expectEmissions: "0 1 2 3 11 14 15 16",
+  expectError: "0 1 2 3 11 14 15 16",
+  expectNoEmission: "0 1 2 3 11 14 15 16",
+  expectNoRequest: "12",
+  expectRequest: "12",
+  ExpectRequestOptions: "12",
+  explainSpy: "7",
+  extendWithAutoSpies: "11",
+  ExtendWithAutoSpiesOptions: "11",
+  FakeTimersConfig: "17",
+  FixtureFactory: "0 1 2 3 14 15 16",
+  FlatConfig: "19",
+  flushEffects: "2 11",
+  flushEventLoop: "0 1 2 3 14 15 16",
+  flushEventLoopUntil: "0 1 2 3 14 15 16",
+  FlushOptions: "12",
+  flushStrayRejections: "17",
+  FlushUntilOptions: "0 1 2 3 14 15 16",
+  formatSpecTiming: "11",
+  formatTestRunComparison: "7",
+  Func: "0 1 2 3 14 15 16",
+  getMockRegistrySize: "17",
+  getPackageCopies: "0 1 2 3 14 15 16 17",
+  getSpyEngine: "17",
+  getTestBedTiming: "11",
+  getWatchedTimerGlobals: "17",
+  GlobalPatchReaction: "17",
+  GlobalRegistratorOptions: "2",
+  guardGlobalPatches: "17",
+  HttpTestingOptions: "12",
+  InjectionLog: "11 13",
+  injectSpy: "2 11 13",
+  inlineAngularResources: "2",
+  installConsoleSpies: "5",
+  installPerTest: "17",
+  installProxyZonePatch: "18",
+  instrumentTestBed: "11",
+  intersectionEntry: "6",
+  IntersectionObserverStubOptions: "6",
+  jasmine: "8",
+  JasmineAccessorSpies: "8 9",
+  JasmineAccessorSpy: "8 9",
+  JasmineAnd: "8 9",
+  JasmineCallInfo: "8 9",
+  JasmineCalls: "8 9",
+  JasmineClassSpyConfiguration: "8",
+  JasmineClock: "8",
+  JasmineMethodSpy: "8 9",
+  JasmineNamespaces: "8 9",
+  JasmineSpy: "8 9",
+  JasmineStrategies: "8 9",
+  JasmineWithArgsAnd: "8 9",
+  JasmineWithArgsSync: "8 9",
+  JsdomModule: "2",
+  JsdomRegistrarOptions: "2",
+  keepMockRegistered: "17",
+  keepRegisteredMocks: "17",
+  MediaElementState: "6",
+  MediaElementStub: "6",
+  MediaElementStubOptions: "6",
+  MethodReturns: "0 1 2 3 14 15 16",
+  mockAccessorsProp: "0 1 2 3 11 14 15 16",
+  mockConstructor: "0 1 2 3 14 15 16",
+  mockDeep: "0 1 2 3 14 15 16",
+  MockDeepOptions: "0 1 2 3 14 15 16",
+  MockedResource: "11",
+  mockNow: "17",
+  mockReadonlyProp: "0 1 2 3 11 14 15 16",
+  mockReadonlyPropGetter: "0 1 2 3 11 14 15 16",
+  mockResourceProp: "11",
+  mockSignalProp: "11",
+  mockSystemTime: "17",
+  mockValueProp: "0 1 2 3 11 14 15 16",
+  moduleNamespace: "0 1 2 3 14 15 16",
+  ModuleNamespace: "0 1 2 3 14 15 16",
+  ModuleNamespaceOptions: "0 1 2 3 14 15 16",
+  Mutable: "0 1 2 3 14 15 16",
+  mutationRecord: "6",
+  MutationRecordInit: "6",
+  narrow: "0 1 2 3 14 15 16",
+  NestModuleRef: "13",
+  NestUnit: "13",
+  NestUnitClass: "13",
+  NestUnitProvider: "13",
+  NestUnitSpies: "13",
+  NestValueProvider: "13",
+  NextValueConfig: "0 1 2 3 4 14 15 16",
+  ObservableLike: "0 1 2 3 14 15 16",
+  ObserverGlobal: "6",
+  ObserverInstance: "6",
+  ObserverSpy: "10",
+  ObserverSpyConfig: "10",
+  ObserverStub: "6",
+  ObserverStubOptions: "6",
+  OnlyMethodKeysOf: "0 1 2 3 8 14 15 16",
+  OnlyObservablePropsOf: "0 1 2 3 8 14 15 16",
+  OnlyPropsOf: "0 1 2 3 8 14 15 16",
+  Overload: "0 1 2 3 14 15 16",
+  Overloads: "0 1 2 3 14 15 16",
+  overrideAutoSpy: "11",
+  overrideComponentProvider: "11",
+  PerTestHandle: "17",
+  PropStubValue: "0 1 2 3 14 15 16",
+  provideAutoSpy: "2 8 11 13 15",
+  provideAutoSpyForToken: "11",
+  provideHttpTesting: "12",
+  ProxyZonePatchOptions: "18",
+  ProxyZoneScope: "18",
+  pruneMockRegistry: "17",
+  pruneNodeMocks: "3",
+  registerDirectiveMatchers: "11",
+  registerDomGlobals: "2",
+  RegisterDomGlobalsOptions: "2",
+  registerFocusMatchers: "17",
+  registerJasmineMatchers: "8",
+  registerResourceMatchers: "11",
+  registerSignalMatchers: "11",
+  RejectionHost: "17",
+  renderShallow: "2 11",
+  RenderShallowOptions: "2 11",
+  reportSpecTiming: "11",
+  RequestErrorOptions: "12",
+  RequestExpectation: "12",
+  RequestMatcher: "12",
+  resetAutoSpy: "0 1 2 3 14 15 16",
+  resetConsoleSpies: "5",
+  resetMockRegistryTracking: "17",
+  resizeEntry: "6",
+  ResizeEntryRect: "6",
+  ResourceDouble: "11",
+  ResourceDoubleStatus: "11",
+  ResourceLike: "11",
+  ResourceStatusLike: "2 11",
+  ResponseBody: "12",
+  restoreConsole: "5",
+  restoreLongLivedImplementations: "17",
+  restoreMockedProps: "0 1 2 3 11 14 15 16",
+  RestoreProp: "0 1 2 3 11 14 15 16",
+  restoreSpiedInstance: "0 1 2 3 14 15 16",
+  restoreTimerGlobals: "17",
+  RuleSeverity: "19",
+  runEffect: "2 11",
+  SchedulerHost: "17",
+  setEmissionTimeout: "0 1 2 3 11 14 15 16",
+  setSpyEngine: "17",
+  settleDynamicImport: "0 1 2 3 14 15 16",
+  settleResource: "2 11",
+  SettleResourceOptions: "2 11",
+  setupAngularTestEnv: "11",
+  setupAutoSpy: "17",
+  SetupAutoSpyOptions: "17",
+  setupFakeTimers: "17",
+  ShallowRender: "2 11",
+  SignalLike: "11",
+  SpecTiming: "11",
+  SpiedFixtures: "11",
+  Spy: "0 1 2 3 8 14 15 16",
+  SpyDisposable: "0 1 2 3 14 15 16",
+  SpyEngine: "17",
+  SpyObj: "8",
+  SpyOptions: "0 1 2 3 14 15 16",
+  SpyRegistry: "2 11",
+  stable: "2 11",
+  StableOptions: "2 11",
+  StopTrackingNodeMocks: "3",
+  StopTrackingRejections: "17",
+  StopTrackingTimers: "17",
+  StrayRejection: "17",
+  StrictSpyConfiguration: "0 1 2 3 14 15 16",
+  stubAbortController: "6",
+  stubConstructor: "0 1 2 3 14 15 16",
+  stubIntersectionObserver: "6",
+  stubMediaElement: "6",
+  stubMutationObserver: "6",
+  stubObserver: "6",
+  stubResizeObserver: "6",
+  SubjectLike: "0 1 2 3 14 15 16",
+  SubjectOf: "0 1 2 3 14 15 16",
+  SubscribableLike: "0 1 2 3 11 14 15 16",
+  SubscriberSpy: "10",
+  subscribeSpyTo: "10",
+  summarizeTestRun: "7",
+  SystemTime: "17",
+  TestBedDiagnosticsOptions: "11",
+  TestRunComparison: "7",
+  TestRunReport: "7",
+  TestRunSummary: "7",
+  TrackedProvider: "11 13",
+  trackInjections: "11 13",
+  TrackInjectionsOptions: "11 13",
+  trackMockRegistry: "17",
+  trackNodeMocks: "3",
+  trackStrayRejections: "17",
+  trackStrayTimers: "17",
+  UnstubbedCall: "0 1 2 3 14 15 16",
+  UnstubbedCallHandler: "0 1 2 3 14 15 16",
+  useCountingClock: "17",
+  ValueConfig: "0 1 2 3 4 14 15 16",
+  ValueConfigPerCall: "0 1 2 3 4 14 15 16",
+  verifyNoPendingRequests: "12",
+  VueInjectionToken: "15",
+  VueProvideSpy: "15",
+  WithMockReturnValue: "0 1 2 3 14 15 16",
+  withOverrides: "0 1 2 3 14 15 16",
+  withSystemTime: "17",
+  XhrBlockMode: "17"
+};
+var AWAITABLE_HELPERS = "advanceTimers expectCompletion expectEmission expectEmissions expectError expectNoEmission flushEventLoop flushEventLoopUntil registerDomGlobals settleDynamicImport settleResource stable withSystemTime";
+
+// src/cli/checks/literals.ts
+var QUOTES = /* @__PURE__ */ new Set(["'", '"']);
+var BLOCK_END = "*/";
+function endOfLineComment(source, start) {
+  const newline = source.indexOf("\n", start);
+  return newline === -1 ? source.length : newline;
+}
+function endOfBlockComment(source, start) {
+  const close = source.indexOf(BLOCK_END, start + BLOCK_END.length);
+  return close === -1 ? source.length : close + BLOCK_END.length;
+}
+function endOfInterpolation(source, start) {
+  let depth = 1;
+  let index = start;
+  while (index < source.length) {
+    const char = source.charAt(index);
+    if (char === "`") {
+      index = endOfTemplate(source, index);
+      continue;
+    }
+    if (QUOTES.has(char)) {
+      index = findStringEnd(source, index);
+      continue;
+    }
+    if (char === "{") {
+      depth += 1;
+    }
+    if (char === "}") {
+      depth -= 1;
+      if (depth === 0) {
+        return index + 1;
+      }
+    }
+    index += 1;
+  }
+  return source.length;
+}
+function endOfTemplate(source, start) {
+  let index = start + 1;
+  while (index < source.length) {
+    const char = source.charAt(index);
+    if (char === "\\") {
+      index += 2;
+      continue;
+    }
+    if (char === "`") {
+      return index + 1;
+    }
+    if (char === "$" && source.charAt(index + 1) === "{") {
+      index = endOfInterpolation(source, index + 2);
+      continue;
+    }
+    index += 1;
+  }
+  return source.length;
+}
+function spanEnd(source, index) {
+  const char = source.charAt(index);
+  if (char === "/") {
+    const next = source.charAt(index + 1);
+    if (next === "/") {
+      return endOfLineComment(source, index);
+    }
+    return next === "*" ? endOfBlockComment(source, index) : -1;
+  }
+  if (QUOTES.has(char)) {
+    return findStringEnd(source, index);
+  }
+  return char === "`" ? endOfTemplate(source, index) : -1;
+}
+function literalSpans(source) {
+  const spans = [];
+  let index = 0;
+  while (index < source.length) {
+    const end = spanEnd(source, index);
+    if (end === -1) {
+      index += 1;
+      continue;
+    }
+    spans.push({ start: index, end });
+    index = end;
+  }
+  return spans;
+}
+function isInsideLiteral(spans, offset) {
+  return spans.some((span) => span.start <= offset && offset < span.end);
+}
+
+// src/cli/checks/entry-imports.ts
+var ENTRIES = ENTRY_SPECIFIERS.split(" ");
+var AWAITABLE = new Set(AWAITABLE_HELPERS.split(" "));
+var NO_OWNERS = [];
+var OWNERS = new Map(
+  Object.entries(EXPORTED_BY).map(([name, indices]) => {
+    const owned = new Set(indices.split(" ").map(Number));
+    return [name, ENTRIES.filter((_entry, index) => owned.has(index))];
+  })
+);
+var NAMES_BY_ENTRY = new Map(
+  ENTRIES.map((entry) => [entry, new Set([...OWNERS].filter(([, owners]) => owners.includes(entry)).map(([name]) => name))])
+);
+var IMPORT = /\bimport\s+(?:type\s+)?([\s\w$*,{}]*?)\s*from\s*["'](vitest-auto-spy(?:\/[\w-]+)?)["']/g;
+var BRACED = /{([^}]*)}/g;
+var RENAME = " as ";
+function parseClause(clause, entry) {
+  const found = [];
+  for (const inner of captures(clause, BRACED)) {
+    for (const raw of inner.split(",")) {
+      const token = raw.trim().replace(/\s+/g, " ").replace(/^type /, "");
+      const rename = token.indexOf(RENAME);
+      if (token !== "") {
+        found.push({
+          entry,
+          name: rename === -1 ? token : token.slice(0, rename),
+          local: rename === -1 ? token : token.slice(rename + RENAME.length)
+        });
+      }
+    }
+  }
+  return found;
+}
+function findEntryImports(source) {
+  const spans = literalSpans(source);
+  const found = [];
+  source.replace(IMPORT, (whole, clause, entry, offset) => {
+    if (!isInsideLiteral(spans, offset)) {
+      found.push(...parseClause(clause, entry));
+    }
+    return whole;
+  });
+  return found;
+}
+function entryExports(entry) {
+  return NAMES_BY_ENTRY.get(entry);
+}
+function ownersOf(name) {
+  return OWNERS.get(name) ?? NO_OWNERS;
+}
+function isAwaitableHelper(name) {
+  return AWAITABLE.has(name);
+}
+function majorOf(version) {
+  return captures(version, /^(\d+)\./g)[0];
+}
+function installedVersion2(cwd) {
+  let directory = cwd;
+  for (; ; ) {
+    const text = readTextFile(join(directory, "node_modules/vitest-auto-spy/package.json"));
+    const parsed = text === void 0 ? void 0 : parseJsonc(text);
+    const version = isRecord(parsed) ? parsed["version"] : void 0;
+    if (typeof version === "string") {
+      return version;
+    }
+    const parent = dirname(directory);
+    if (parent === directory) {
+      return void 0;
+    }
+    directory = parent;
+  }
+}
+function tableApplies(cwd) {
+  const installed = installedVersion2(cwd);
+  const theirs = installed === void 0 ? void 0 : majorOf(installed);
+  return theirs === void 0 || theirs === majorOf(EXPORT_MAP_VERSION);
+}
+
+// src/cli/checks/helper-entry.ts
+function candidates(owners, preferred) {
+  return owners.includes(preferred) ? [preferred] : owners;
+}
+function findingFor(file, entry, name, owners) {
+  const list = owners.map((owner) => `\`${owner}\``).join(" or ");
+  return {
+    check: "helper-from-wrong-entry",
+    severity: "error",
+    file,
+    message: `Imports \`${name}\` from \`${entry}\`, which does not export it.`,
+    fix: `Change the specifier to ${list}. The entry point decides which mock adapter and which framework wiring the file gets, which is why the name is not re-exported from the root.`
+  };
+}
+function checkHelperEntry(profile, graph) {
+  if (!tableApplies(profile.cwd)) {
+    return [];
+  }
+  const findings = [];
+  for (const [file, text] of graph.texts) {
+    for (const { entry, name } of findEntryImports(text)) {
+      const exported = entryExports(entry);
+      const owners = candidates(ownersOf(name), profile.entry);
+      if (exported !== void 0 && !exported.has(name) && owners.length > 0) {
+        findings.push(findingFor(file, entry, name, owners));
+      }
+    }
+  }
+  return findings;
+}
 var JASMINE_PACKAGES = ["@hirez_io/observer-spy", "@types/jasmine", "jasmine-auto-spies", "jasmine-core"];
 var KARMA_PACKAGE = /^karma/;
 var KARMA_CONFIG = /(^|\/)karma\.conf\.[cm]?[jt]s$/;
@@ -2446,7 +2962,7 @@ function checkOrphanRunnerConfig(profile, graph) {
 }
 
 // src/cli/checks/spec-imports.ts
-function findingFor(importer, imported) {
+function findingFor2(importer, imported) {
   if (isSpecFile(importer)) {
     return {
       check: "spec-exports-fixture",
@@ -2469,7 +2985,7 @@ function checkSpecImports(graph) {
   for (const [importer, imported] of graph.imports) {
     for (const target of imported) {
       if (isSpecFile(target)) {
-        findings.push(findingFor(importer, target));
+        findings.push(findingFor2(importer, target));
       }
     }
   }
@@ -2580,6 +3096,78 @@ function checkTsconfigGlobs(profile) {
   return configs.flatMap((config) => checkOne(profile.cwd, config, profile.files));
 }
 
+// src/cli/checks/unawaited-helper.ts
+var QUOTES2 = /* @__PURE__ */ new Set(["'", '"', "`"]);
+var SPACING = /* @__PURE__ */ new Set([" ", "	"]);
+var STATEMENT_ENDERS = /* @__PURE__ */ new Set(["", ";", "\n", "\r", "}"]);
+function awaitableLocals(source) {
+  const locals = findEntryImports(source).filter(({ name }) => isAwaitableHelper(name)).map(({ local }) => local);
+  return [...new Set(locals)];
+}
+function endOfCall(source, open) {
+  let depth = 0;
+  let index = open;
+  while (index < source.length) {
+    const char = source.charAt(index);
+    if (QUOTES2.has(char)) {
+      index = findStringEnd(source, index);
+      continue;
+    }
+    if (char === "(") {
+      depth += 1;
+    }
+    if (char === ")") {
+      depth -= 1;
+      if (depth === 0) {
+        return index;
+      }
+    }
+    index += 1;
+  }
+  return -1;
+}
+function isStatementEnd(source, from) {
+  let index = from;
+  while (SPACING.has(source.charAt(index))) {
+    index += 1;
+  }
+  return STATEMENT_ENDERS.has(source.charAt(index));
+}
+function findUnawaitedCalls(source, locals) {
+  if (locals.length === 0) {
+    return [];
+  }
+  const spans = literalSpans(source);
+  const pattern = new RegExp(`(?:^|[;{}])\\s*(${locals.join("|")})\\s*\\(`, "g");
+  const found = [];
+  source.replace(pattern, (whole, local, offset) => {
+    const close = endOfCall(source, offset + whole.length - 1);
+    if (!isInsideLiteral(spans, offset) && close !== -1 && isStatementEnd(source, close + 1)) {
+      found.push(local);
+    }
+    return whole;
+  });
+  return found;
+}
+function checkUnawaitedHelper(profile, graph) {
+  if (!tableApplies(profile.cwd)) {
+    return [];
+  }
+  const findings = [];
+  for (const [file, text] of graph.texts) {
+    for (const local of new Set(findUnawaitedCalls(text, awaitableLocals(text)))) {
+      findings.push({
+        check: "no-unawaited-helper",
+        severity: "error",
+        file,
+        message: `Calls \`${local}()\` as a statement and drops the promise it returns.`,
+        fix: "Await it. Unawaited, it settles after the test has already ended, so the assertion inside it can only report into a later test \u2014 or nowhere at all."
+      });
+    }
+  }
+  return findings;
+}
+
 // src/cli/doctor.ts
 function runDoctor(profile) {
   const graph = buildGraph(profile);
@@ -2591,7 +3179,9 @@ function runDoctor(profile) {
     ...checkAngularBuild(profile),
     ...checkCoverageConfig(profile),
     ...checkAgentInstructions(profile),
-    ...checkJasmineEra(profile)
+    ...checkJasmineEra(profile),
+    ...checkHelperEntry(profile, graph),
+    ...checkUnawaitedHelper(profile, graph)
   ];
 }
 
@@ -3132,10 +3722,10 @@ function findDomFreeSpecs(profile, graph) {
   for (const [file, text] of graph.texts) {
     locals.set(file, classify(file, text, known, aliases));
   }
-  const candidates = [...graph.texts].filter(([file, text]) => isSpecFile(file) && !DECLARED_ENVIRONMENT.test(text)).map(([file]) => file);
+  const candidates2 = [...graph.texts].filter(([file, text]) => isSpecFile(file) && !DECLARED_ENVIRONMENT.test(text)).map(([file]) => file);
   const setup = profile.setupFiles.map((entry) => entry.replace(/^\.\//, ""));
-  const specs = candidates.filter((file) => isClean(file, setup, locals));
-  return { specs, undecided: candidates.length - specs.length };
+  const specs = candidates2.filter((file) => isClean(file, setup, locals));
+  return { specs, undecided: candidates2.length - specs.length };
 }
 
 // src/cli/perf-data.ts