module-registry

Module Registry Context

When working with any code related to module resolution, compilation, evaluation, or registration in workerd, you must read the relevant reference documents before making changes or providing analysis. These documents capture the design decisions, data flow, thread safety model, and integration points that are not obvious from reading the source alone.

Reference Documents

Read these documents (using the Read tool) before proceeding with any module registry work:

1. docs/reference/detail/new-module-registry.md — The new jsg::modules::ModuleRegistry implementation. Covers the two-layer architecture (shared ModuleRegistry + per-isolate IsolateModuleRegistry), bundle types, resolution priority, compile cache, evaluation flow, and thread safety model. Read this first for any work on the new registry.