fix(compartment-mapper): policy, parser type fixes

[boneskull]

• Fixes CompartmentDescriptor so that it is generic on the PackagePolicy; externally-defined ParseFns can now refer to the specific contents of a custom PackagePolicy present in a CompartmentDescriptor.
• Introduces ParseSourceMapHook; differentiated from @endo/module-source's SourceMapHook.
• Fixes type of PolicyItem; eliminates confusion between void (no extra union members) and any (SomePackagePolicy).

[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 makeEvasiveTransformVisitor #3217 is merged into master.

📚 Pull Request Stack

• branch: master
  • feat(evasive-transform): expose makeEvasiveTransformVisitor #3217 - branch: boneskull/evasive-pipeline2
    • fix(compartment-mapper): policy, parser type fixes #3247 - branch: boneskull/fix-module-source-types2 (this PR)
      • 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: 4c88284

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

This PR includes changesets to release 1 package

Name	Type
@endo/compartment-mapper	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

[Copilot]

Pull request overview

This PR updates @endo/compartment-mapper’s public TypeScript types to better model policy generics and parser hooks, improving the accuracy of external parser/plugin type-checking.

Changes:

• Make CompartmentDescriptor generic over the compartment PackagePolicy, enabling externally-defined ParseFns to “see” custom policy shapes.
• Introduce ParseSourceMapHook (distinct from SourceMapHook) and thread a generic TCompartmentDescriptor through parser types.
• Fix PolicyItem typing so any no longer collapses the “custom policy item” branch into the void branch.

Reviewed changes

Copilot reviewed 8 out of 9 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
yarn.lock	Updates lockfile to reflect dependency changes (adds @types/node, removes babel-eslint).
packages/module-source/package.json	Adjusts devDependencies (adds @types/node, removes babel-eslint).
packages/compartment-mapper/src/types/typescript.ts	Adds IsAny<T> helper for distinguishing wide any in conditional types.
packages/compartment-mapper/src/types/policy-schema.ts	Refines PolicyItem typing and updates policy generic parameter naming and “any policy” aliases.
packages/compartment-mapper/src/types/external.ts	Adds ParseSourceMapHook, factors parse options, and makes parser types generic over compartment descriptor type.
packages/compartment-mapper/src/types/compartment-map-schema.ts	Extends CompartmentDescriptor generics to include policy type; adds “any descriptor” helper types.
packages/compartment-mapper/src/parse-mjs.js	Adds a temporary @ts-expect-error for sourceMapHook typing pending a follow-up change.
packages/compartment-mapper/src/parse-archive-mjs.js	Same temporary @ts-expect-error for sourceMapHook typing.
.changeset/huge-mammals-give.md	Adds a changeset entry documenting the type-level fixes.

---

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

[naugtur]

machines are complaining, but I don't care. up to you