## push · function

Modify the current route by merging `target` into it (using | A.merge), pushing a new history entry.

This is useful for things like opening modals or side panels, where you want a browser back action to return to the previous state.

**Signature:** `(target: RouteTarget, nav?: NavType) => boolean | Promise<boolean>`

**Parameters:**

- `target: RouteTarget` - Same as for `go`, but merged into the current route instead deleting all state.
- `nav?: NavType` - The navigation type to use. Defaults to `undefined`, meaning the navigation type is unchanged from the current route,
preventing unwanted page transition animations.

**Returns:** The `go` verdict: `false` when a guard vetoed the navigation.
