Ship the shared Boehm in the Windows release package

A program that loads a tslang shared library needs Boehm as a DLL (item
5ao), but the release zip only carried the static gc.lib. The release
workflow now builds the shared collector before configuring tslang, so its
own -shared tests run, and packages gc.lib (import library) + gc.dll under
gcdll/ - a separate folder because both libraries are named gc.lib.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: ASDAlexander77

.github/workflows/create-release.yml

@@ -122,6 +122,28 @@ jobs:
         run: cmake --install . --config ${{ env.BUILD_TYPE }}
         shell: pwsh
 
+      # Boehm as a DLL: an executable and a tslang shared library that each link the static
+      # gc.lib get two collectors, and one frees what the other still holds (item 5ao). Used by
+      # the -shared tests, and shipped in the zip's gcdll folder. Mirrors
+      # scripts/build_gc_release_shared_vs.bat; installed before tslang is configured, since the
+      # test CMakeLists checks for it at configure time.
+      - name: Configure GC (shared)
+        continue-on-error: false
+        run: New-Item -ItemType Directory -Force -Path ".\__build\gcdll\msbuild\x64\release" | Out-Null; cd ".\__build\gcdll\msbuild\x64\release"; cmake ../../../../../3rdParty/gc-${{ env.GC_VERSION }} -G "Visual Studio 18 2026" -A x64 -Wno-dev -DCMAKE_INSTALL_PREFIX=${{github.workspace}}/3rdParty/gcdll/x64/release -DBUILD_SHARED_LIBS=ON -Denable_threads=ON -Denable_cplusplus=OFF -Denable_docs=OFF -DCMAKE_POLICY_DEFAULT_CMP0091=NEW -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreaded
+        shell: pwsh
+
+      - name: Build GC (shared)
+        continue-on-error: false
+        working-directory: ${{github.workspace}}/__build/gcdll/msbuild/x64/release
+        run: cmake --build . --config ${{ env.BUILD_TYPE }} -j 8
+        shell: pwsh
+
+      - name: Install GC (shared)
+        continue-on-error: false
+        working-directory: ${{github.workspace}}/__build/gcdll/msbuild/x64/release
+        run: cmake --install . --config ${{ env.BUILD_TYPE }}
+        shell: pwsh
+
       - name: Configure
         continue-on-error: false
         working-directory: ${{github.workspace}}/__build/tslang/msbuild/x64/release
@@ -182,7 +204,12 @@ jobs:
         # are preserved:
         #   defaultlib/{dll,lib}/{debug,release}/{gc,rc,none},
         #   defaultlib/*.d.ts, defaultlib/generics/
-        run: Get-ChildItem -Path .\tslang\msbuild\x64\release\bin\tslang.exe, .\tslang\msbuild\x64\release\bin\TypeScriptRuntime.dll, .\gc\msbuild\x64\release\${{ env.BUILD_TYPE }}\gc.lib, .\tslang\msbuild\x64\release\lib\TypeScriptAsyncRuntime.lib, ..\3rdParty\llvm\x64\release\lib\LLVMSupport.lib, ..\3rdParty\llvm\x64\release\bin\wasm-ld.exe, ..\TypeScriptCompilerDefaultLib\__build | Compress-Archive -DestinationPath ..\tslang.zip
+        # plus the shared collector in its own folder, because its import library is also named
+        # gc.lib: gcdll/gc.lib + gcdll/gc.dll, for programs that load a tslang shared library.
+        run: |
+          New-Item -ItemType Directory -Force -Path .\gcdll_stage\gcdll | Out-Null
+          Copy-Item -Path ..\3rdParty\gcdll\x64\release\lib\gc.lib, ..\3rdParty\gcdll\x64\release\bin\gc.dll -Destination .\gcdll_stage\gcdll -ErrorAction Stop
+          Get-ChildItem -Path .\tslang\msbuild\x64\release\bin\tslang.exe, .\tslang\msbuild\x64\release\bin\TypeScriptRuntime.dll, .\gc\msbuild\x64\release\${{ env.BUILD_TYPE }}\gc.lib, .\tslang\msbuild\x64\release\lib\TypeScriptAsyncRuntime.lib, ..\3rdParty\llvm\x64\release\lib\LLVMSupport.lib, ..\3rdParty\llvm\x64\release\bin\wasm-ld.exe, ..\TypeScriptCompilerDefaultLib\__build, .\gcdll_stage | Compress-Archive -DestinationPath ..\tslang.zip
         shell: pwsh
 
       - name: Archive Zip of Windows Asset

docs/memory-models.md

@@ -124,8 +124,13 @@ the executable's roots, so it frees objects the executable is still holding. The
 a crash: the freed memory is reallocated and the program reads a plausible wrong value, which
 only shows up when what was written over it differs from what was there.
 
-Build the shared collector with `scripts/build_gc_release_shared_vs.bat`, link against
-`3rdParty/gcdll/x64/release/lib/gc.lib`, and ship `gc.dll` beside the executable.
+The Windows release package ships the shared collector in its `gcdll` folder, beside the static
+`gc.lib` at its root — both files are named `gc.lib`, so the folder is what tells them apart.
+Compile the executable **and** every shared library with `--gc-lib-path=<package>/gcdll`, and
+ship `gcdll/gc.dll` beside the executable.
+
+From a source build, the same files come from `scripts/build_gc_release_shared_vs.bat`: link
+against `3rdParty/gcdll/x64/release/lib/gc.lib` and ship `3rdParty/gcdll/x64/release/bin/gc.dll`.
 
 Statically linked programs are unaffected and keep the static `gc.lib` — one binary already
 means one collector. `-mm=rc` and `-mm=none` are unaffected either way: neither has a collector.