The following covers the arrays as they are returned from px-engine and how they can be used in Themes and Add-ons.
$pagedata
Additional properties that can be used are: id, parent (based on id), layout (page.php, index.php, etc), modified (datetime), visible, and listby.
Two columns are included and currently unused: segment and option.