feat(evasive-transform): expose makeEvasiveTransformVisitor

[boneskull]

Extracts makeTransformCommentsVisitor from transformAst and exports it via a new ./visitor.js subpath.

transformAst is reimplemented as a thin wrapper that calls makeTransformCommentsVisitor and traverses — no logic change, just inversion of control.

Additional tidy-ups in the same diff:

• SourceType now includes commonjs, and parseAst passes allowReturnOutsideFunction: true for that source type (which it does by default, if we didn't have it being set for script as well)
• SourceMapOption type removed; its usages are replaced with object | string (actual referenced type does not exist)
• Inline import() type references in JSDoc replaced with @import declarations at the top of each file.
• stripInternal: true added to tsconfig.json so @internal items are excluded from generated .d.ts output.
• @types/babel__generator and @types/babel__traverse (prod) added as dependencies (they were missing)

[boneskull]

📚 Pull Request Stack

• branch: master
  • feat(evasive-transform): expose makeEvasiveTransformVisitor #3217 - branch: boneskull/evasive-pipeline2 (this PR)
    • fix(compartment-mapper): policy, parser type fixes #3247 - branch: boneskull/fix-module-source-types2
      • feat(module-source): fix types, expose analyzer.js subpath #3218 - branch: boneskull/module-source-pipeline2
        • feat(module-source): expose AST-based CJS parser #3220 - branch: boneskull/cjs-ast-parser2
          • feat(compartment-mapper): expose findUnknownCanonicalNames #3221 - branch: boneskull/export-find-canonical-names2
            • feat(parser-pipeline): create @endo/parser-pipeline #3158 - branch: boneskull/ast-service

---

Managed by gh-stack

[changeset-bot]

🦋 Changeset detected

Latest commit: ce5b1cc

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@endo/evasive-transform	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull request overview

This PR exposes a new low-level Babel visitor factory from @endo/evasive-transform via a visitor.js subpath, refactoring transformAst into a wrapper that constructs the visitor and then traverses the AST. It also includes type/JSDoc cleanups, adjusts parser options for an added commonjs source type, and tweaks TypeScript declaration generation.

Changes:

• Extract and export makeEvasiveTransformVisitor via a new visitor.js entrypoint and refactor transformAst to use it.
• Extend SourceType with commonjs and adjust parseAst’s allowReturnOutsideFunction behavior.
• Type/JSDoc and build tidy-ups (remove SourceMapOption, add stripInternal, add missing Babel @types/* deps).

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
yarn.lock	Adds lock entries for @types/babel__generator / @types/babel__traverse and their transitive deps.
packages/evasive-transform/visitor.js	Adds a top-level entrypoint re-exporting the visitor factory.
packages/evasive-transform/tsconfig.json	Enables stripInternal for generated declarations.
packages/evasive-transform/src/visitor.js	Introduces src entrypoint exporting the visitor factory from transform-ast.js.
packages/evasive-transform/src/transform-code.js	JSDoc @import refactor and minor internal cleanup in transforms.
packages/evasive-transform/src/transform-ast.js	Extracts visitor factory and makes transformAst a wrapper around traverse + visitor.
packages/evasive-transform/src/parse-ast.js	Adds commonjs to SourceType and adjusts parse options.
packages/evasive-transform/src/index.js	Replaces removed SourceMapOption usage with `object
packages/evasive-transform/src/generate.js	Removes SourceMapOption typedef; minor doc formatting; TS suppression for inputSourceMap.
packages/evasive-transform/package.json	Exposes ./visitor.js subpath and adds Babel @types/* dependencies.
.changeset/itchy-meteors-cover.md	Declares a minor bump and documents the new entrypoint.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[boneskull]

This is incorrect; commonjs is an allowed value (and is in fact preferred over script for our use-case).

[naugtur]

I have read and understood the changes and they are correct.