fix(runtime): resolve native-constructor superclass prototype in dynamic extends

[proggeramlug]

Lands #8763 (fixes #8760).

Booting the natively compiled Claude Code cli.js 2.1.112 bundle threw TypeError: Class extends value does not have valid prototype property at module init on nearly every command — only --version escaped. The raw prototype dynamic slot on a bound native-module export closure is still undefined at that point, so resolution has to fall through to the same lazy materialization an ordinary EE.prototype read uses.

One fix on top

class_id_collisions.py went red. It matches any *CLASS_ID: u32 = and deliberately ignores scope — its own header says the point is "not to depend on someone remembering the scope". The new test declared a function-local const CLASS_ID alongside the existing #8001 fixture's, so two same-named constants held different values (0x7d01_8001 vs 0x7d01_8760) and the gate read that as a drifted cross-crate mirror.

Since the gate's ignoring of scope is intentional, the right remedy is a distinct name rather than working around the check: the new fixture's constant is now ISSUE_8760_CLASS_ID, and the #8001 test is untouched.

Validation (on the merged result)

• All 30 lint-job checkers pass (class_id_collisions.py included, after the rename)
• perry-runtime --lib (RUST_TEST_THREADS=1): 2674 passed, 0 failed (+1)
• The PR's own test verified running by name: native_constructor_export_parent_links_declared_prototype ... ok
• Squashed tree verified identical to the validated tree

The PR carried its own changelog.d/ fragment. No version bump.

Summary by CodeRabbit

• Bug Fixes
  • Fixed class inheritance from directly imported native constructors, including event, stream, network, and HTTP server classes.
  • Classes now correctly inherit from constructors whose prototype is created on demand.
  • Invalid prototype-less functions continue to produce an appropriate error.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: eb2bcf6c-9239-441d-b218-e3eebc011c8f

📥 Commits

Reviewing files that changed from the base of the PR and between 20a3889 and 3383d4c.

📒 Files selected for processing (2)

• changelog.d/8760-class-extends-native-constructor-prototype.md
• crates/perry-runtime/src/object/class_registry/state.rs

---

📝 Walkthrough

Walkthrough

The runtime now lazily resolves prototypes for bound native-module constructors used in class extends. The change preserves errors for prototype-less bound functions and adds coverage for events.EventEmitter.

Changes

Native constructor prototype resolution

Layer / File(s)	Summary
Lazy prototype resolution and validation crates/perry-runtime/src/object/class_registry/state.rs, changelog.d/8760-class-extends-native-constructor-prototype.md	class_decl_prototype_value resolves lazily materialized native constructor prototypes before validation. A runtime test verifies the EventEmitter prototype link and the changelog records the behavior.
Inheritance regression coverage crates/perry-runtime/src/object/class_registry/state.rs	The test confirms that the raw bound constructor prototype is initially undefined, then verifies materialization and canonical prototype linkage.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: thehypnoo

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch merge/b39

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}