feat(module-source): fix types, expose analyzer.js subpath

[boneskull]

Introduces a low-level analysis primitive analyzeModule which is exported from the analyzer.js subpath.

• Adds src/types/external.ts as a single re-export index for the public types (SourceMapHook, SourceMapHookDetails, SourceMapObject, ModuleSourceOptions) and the new analyzer types. src/external.types.d.ts now delegates to it.

• Adds src/types/analyzer.ts with AnalysisContext<T>, ModuleAnalysisContext, AnalysisOptions, and VisitorPlugin — typed by tsc rather than inferred from JSDoc.

• Adds src/shim.types.d.ts for the global ModuleSource augmentation used by the SES shim.

• tsconfig.json is tightened: stripInternal removes @internal declarations from emitted .d.ts files.

• Update typedoc.json to also consider the additional entry points

• We no longer need to provide custom @babel/types exports to these functions. So, makeModulePlugins and makeCjsModulePlugins no longer return PluginFactory functions (({ types }) => ({ visitor })). Both now return plain { analyzePlugin: { visitor }, transformPlugin: { visitor } } objects with @babel/types imported at module scope. transform-source.js is updated accordingly.

• Benchmark and test fixture updated for the new API shape.

• Adds ./analyzer.js as a new package export. The analyzeModule(options?) function creates a fresh per-parse context with analyzePass / transformPass (plain Visitor objects) and buildRecord(code, location). The same function powers the ModuleSource constructor internally. This will be consumed by the forthcoming @endo/parser-pipeline.

[boneskull]

Warning

This PR is part of a stack and targets branch boneskull/evasive-pipeline2, not master.
DO NOT MERGE until feat(evasive-transform): expose makeTransformCommentsVisitor #3217 is merged into master.

📚 Pull Request Stack

• branch: master
  • fix(compartment-mapper,bundle-source): async parser support #3186 - branch: boneskull/async-parser
    • feat(evasive-transform): expose makeTransformCommentsVisitor #3217 - branch: boneskull/evasive-pipeline2
      • feat(module-source): fix types, expose analyzer.js subpath #3218 - branch: boneskull/module-source-pipeline2 (this PR)
        • fix(compartment-mapper): policy, parser type fixes #3219 - branch: boneskull/fix-module-source-types
          • 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: c604f08

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

This PR includes changesets to release 8 packages

Name	Type
@endo/module-source	Minor
@endo/compartment-mapper	Patch
@endo/bundle-source	Patch
@endo/check-bundle	Patch
@endo/daemon	Patch
@endo/import-bundle	Patch
@endo/test262-runner	Patch
@endo/cli	Patch

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