[WIP] Begin moving towards invokable wire format

[wycats]

No description provided.

[github-actions]

	This PR	main
Dev	603K └─┬ . 169K ├── runtime 159K ├── syntax 111K ├── compiler 67K ├── opcode-compiler 27K ├── manager 19K ├── validator 11K ├── program 8.9K ├── reference 7.2K ├── destroyable 6.3K ├── util 4.3K ├── node 3.4K ├── wire-format 3.4K ├── global-context 1.0K ├── vm 969B ├── encoder 844B ├── vm-babel-plugins 606B └── owner	582K └─┬ . 169K ├── runtime 159K ├── syntax 100K ├── compiler 58K ├── opcode-compiler 27K ├── manager 19K ├── validator 11K ├── program 8.9K ├── reference 7.2K ├── destroyable 6.3K ├── util 4.3K ├── node 3.4K ├── global-context 2.5K ├── wire-format 1.0K ├── vm 969B ├── encoder 844B ├── vm-babel-plugins 606B └── owner
Prod	237K └─┬ . 69K ├── syntax 63K ├── runtime 52K ├── compiler 21K ├── opcode-compiler 7.9K ├── manager 4.8K ├── program 4.0K ├── validator 3.6K ├── reference 2.4K ├── util 2.3K ├── wire-format 2.1K ├── node 1.5K ├── destroyable 737B ├── vm 594B ├── global-context 516B ├── encoder 469B ├── vm-babel-plugins 155B └── owner	230K └─┬ . 69K ├── syntax 63K ├── runtime 48K ├── compiler 18K ├── opcode-compiler 7.9K ├── manager 4.8K ├── program 4.0K ├── validator 3.6K ├── reference 2.4K ├── util 2.1K ├── node 1.6K ├── wire-format 1.5K ├── destroyable 737B ├── vm 594B ├── global-context 516B ├── encoder 469B ├── vm-babel-plugins 155B └── owner

[Copilot]

Pull Request Overview

This PR begins transitioning towards an invokable wire format by updating integration test harnesses, refining event recording and cache behavior, and adding comprehensive documentation and pseudocode for the Glimmer reactivity system.

• Updated integration tests with new CSS and improved event recording handling.
• Refactored build configuration to adjust the typescript helper and updated the benchmark environment to reference layout compilation.
• Added extensive documentation and pseudocode for the reactive system, including tags, primitives, and composition.

Reviewed Changes

Copilot reviewed 171 out of 176 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
packages/@glimmer-workspace/integration-tests/lib/setup-harness.ts	Added import for new CSS tweaks.
packages/@glimmer-workspace/integration-tests/lib/render-test.ts	Extended test interfaces and recording event functionality.
packages/@glimmer-workspace/integration-tests/lib/modes/jit/delegate.ts	Minor whitespace adjustment.
packages/@glimmer-workspace/integration-tests/lib/compile.ts	Updated precompileJSON call with meta information.
packages/@glimmer-workspace/integration-tests/index.ts	Updated exports to include additional test helpers.
packages/@glimmer-workspace/build/lib/config.js	Refactored typescript function signature and adjusted SWC settings.
packages/@glimmer-workspace/benchmark-env/lib/benchmark/util.ts	Replaced reference to compilable with layout in entry compilation.
guides/reactivity/*	New and updated documentation and pseudocode for the reactivity system.

Files not reviewed (5)

• .prototools: Language not supported
• .vscode/settings.json: Language not supported
• package.json: Language not supported
• packages/@glimmer-workspace/build/package.json: Language not supported
• packages/@glimmer-workspace/integration-tests/lib/harness/tweaks.css: Language not supported

Comments suppressed due to low confidence (3)

packages/@glimmer-workspace/build/lib/config.js:410

• The typescript() function signature was changed by removing the package parameter. Please ensure all callers have been updated accordingly and update any related documentation or JSDoc to reflect this change.

              typescript(env),

packages/@glimmer-workspace/benchmark-env/lib/benchmark/util.ts:5

• The property reference was changed from 'compilable' to 'layout'. Verify that 'layout' exists on entry and that this change is consistent with the intended API to avoid compilation issues.

  return unwrapHandle(entry.layout!.compile(context));

packages/@glimmer-workspace/integration-tests/lib/render-test.ts:112

• [nitpick] This diff introduces private class fields (using the '#' syntax). Ensure that the target TypeScript/JavaScript environment fully supports private fields to avoid runtime errors.

  #events: RecordedEvent[] = [];

[reteps]

Any way that I can contribute? In the context of #1666, this would be very helpful.

[NullVoxPopuli]

idk, basically what's left here is that I need to add tests, and make sure CI goes green