frostney / frostney/GocciaScript

Add explicit module replacement for tests

Open
#1,039 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

new feature runtime
Dominant language
Pascal
Stars
20
Forks
3
Avg merge
3d 4h
Merged PRs (30d)
45

Description

Summary

Add a project-native testing API for explicitly replacing imported modules and restoring module state during tests.

Why

Function mocks and spies cannot isolate code whose dependency is captured through an ES module import. Tests need a controlled loader-level replacement mechanism that preserves GocciaScript's sandbox and module semantics.

Current behavior

The testing runtime provides mock() and spyOn() for callable values. TGocciaModuleLoader owns resolved-module caches and host-configured virtual modules, but the testing library has no per-test replacement, reset, or restore surface.

Expected behavior

  • Allow tests to register an explicit replacement module or replacement factory before that module is evaluated.
  • Resolve replacement specifiers through the same aliases, import maps, and canonical identities as normal imports.
  • Define cache behavior and ES module live-binding behavior for replaced exports.
  • Restore or reset replacements reliably between test files and at the requested test/suite boundary.
  • Keep replacement state isolated across serial and --jobs runs and equivalent across interpreter/bytecode modes.
  • Provide diagnostics for late, conflicting, or unresolved replacements.

Scope notes

  • Prefer an explicit API that fits the existing testing runtime; do not require a vi.* namespace.
  • Transform-hoisted static-import mocking, automatic deep mocking, Vite transform behavior, CommonJS, and Node/npm module resolution are out of scope.
  • Host-configured virtual modules remain an embedding capability rather than becoming ambient test authority.
  • Related #119 implemented function-level mock/spy infrastructure, not module replacement; #114 is the closed parent API issue.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading TGocciaModuleLoader and the existing testing runtime APIs, including mock() and spyOn(), to understand module caches, virtual modules, and test boundaries. Define the replacement, reset, restore, isolation, and diagnostic behavior within the stated scope, then verify it across serial and --jobs runs and interpreter/bytecode modes.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
compilers, testing
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.