Skip to content

Add design docs: LLVM GC integration and C/C++ header import#197

Merged
ASDAlexander77 merged 1 commit into
mainfrom
docs/gc-and-c-header-import
Jul 10, 2026
Merged

Add design docs: LLVM GC integration and C/C++ header import#197
ASDAlexander77 merged 1 commit into
mainfrom
docs/gc-and-c-header-import

Conversation

@ASDAlexander77

Copy link
Copy Markdown
Owner

Summary

  • docs/llvm-gc-integration.md — estimate of which parts of LLVM's GC framework (GCStrategy, gc attribute, llvm.gcroot, llvm.gcwrite, statepoints/stack maps) are applicable alongside the project's existing Boehm GC, phased by effort/benefit.
  • docs/c-cpp-header-import.md — plan for converting C/C++ header declarations into tslang declarations, covering an AST-based clang importer (tsbindgen), C→tslang type mapping, and an ABI-safe wrapper-emission approach that links a clang-produced LLVM module into the compiler's own module.

Test plan

  • Docs only, no code changes.

… plan

Documents an estimate for using LLVM's GCStrategy/gcroot/gcwrite framework
alongside the existing Boehm GC, and a plan for generating tslang
declarations from C/C++ headers via an in-process clang importer (AST-based
mapping plus optional wrapper-emission/LLVM IR linking for ABI-correct
struct-by-value calls).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@ASDAlexander77
ASDAlexander77 merged commit b0a71a1 into main Jul 10, 2026
2 checks passed
@ASDAlexander77
ASDAlexander77 deleted the docs/gc-and-c-header-import branch July 10, 2026 23:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant