The state we transform through the pipeline

Compose two attribute transformers

State transformers

Core primitives

Pin a specific version and hash
Automatically substitutes version in the existing URL
Usage: pin "2.1.12" "sha256-..."

Full source override (for when pin doesn't work)
Usage: src "2.1.12" "sha256-..." (v: "https://.../${v}.tar.gz")

Extract pname from package

Build a port with automatic pname extraction
Usage: for pkgs.coreutils [skipCheck]

for "flask" [skipCheck]  (for Python/sub-overlays)

For explicit names: { bash = for pkgs.bash [...]; }

Common helpers reason parameter is for documentation only - doesn't affect the build

Mark as broken for Fil-C with a reason
Only sets broken/badPlatforms when actually cross-compiling to Fil-C

Mark packages as memory-safe when built with Fil-C
Removes knownVulnerabilities since memory safety eliminates whole classes of bugs

AST-based code rewriting using ast-grep
Usage: astRewrite "file.c" "c" "pattern with $VAR" "replacement with $VAR" Patterns use ast-grep syntax: $VAR for single node, $$$VAR for multiple nodes

URL helpers

DSL functions to export

Create an overlay from a list of port specs
Each item in portList is either:

- A port spec: { pname, attrs, overrideArgs, ... }
- An attrset with explicit names: { foo = <port-spec>; bar = <port-spec>; }