What is the usual way to uninstall program installed by a .pkg file in Mac OS X?
With most apps, the user just drags the .app bundle to the trash. The .app bundle is really a folder but acts like a file as far as the user is concerned.
Lazarus and FPC are development tools and don't install .app bundles but rather various files and folders under /usr/local. I suppose a script would make the most sense here and developers should be able to use it. I believe that's what Mono does.
If the Carbon widgetset could one day be used to generate a native Lazarus executable that could be distributed as part of an .app bundle, Lazarus itself could be installed in the normal /Applications or /Developers (not at my Mac, but I think that's what it's called) folder. However, the FPC and LCL compiled units and source code would probably still go under /usr/local or in the user's home folder (perhaps this could be selected at installation). Technically, compiled units and source code could also go in the .app bundle as part of the app's resources, but this probably isn't the usual place with development tools.
With a Lazarus .app bundle, the user would then be able to start Lazarus by double-clicking, drag and drop it on the dock or move it anywhere they want, and easily uninstall it by dragging it to the trash.
Note that Apple's Xcode IDE is a normal OS X app bundle.