feat: Add transferFromNeeded to non permit2 methods

This will block an attempt to transfer from the user when we expect the funds to already be in the router.

chores:
- add docs
- in EncodingContext, rename transfer to transfer_type

Took 58 minutes

foundry/test/TychoRouterTestSetup.sol

@@ -28,10 +28,15 @@ contract TychoRouterExposed is TychoRouter {
         return _unwrapETH(amount);
     }
 
-    function tstoreExposed(address tokenIn, uint256 amountIn, bool isPermit2)
-        external
-    {
-        _tstoreTransferFromInfo(tokenIn, amountIn, isPermit2);
+    function tstoreExposed(
+        address tokenIn,
+        uint256 amountIn,
+        bool isPermit2,
+        bool transferFromNeeded
+    ) external {
+        _tstoreTransferFromInfo(
+            tokenIn, amountIn, isPermit2, transferFromNeeded
+        );
     }
 
     function exposedSplitSwap(