@ilha/void

Exports, plugin options, and types for the Void integration.

Import paths

Import path	Use it for
`@ilha/void`	`Link`, `Form`, hooks, form helpers, and types
`@ilha/void/plugin`	`voidIlha()` Vite plugin
`@ilha/void/client`	`startPages()`; the generated pages client calls it
`@ilha/void/islands`	`mountIsland()`; the generated islands client calls it
`@ilha/void/server`	`createPageRenderer()` and friends; generated modules call them

Import client, islands, and server only if you write your own entries. Void’s generated modules use them.

`voidIlha(options?)`

Returns the Vite plugins that render and hydrate Void pages with Ilha. Add it after voidPlugin().

Option	Type	Default	Meaning
`viewTransitions`	`boolean`	`false`	Wrap router navigations in `document.startViewTransition()`
`prefetch.hoverDelay`	`number`	`75`	Milliseconds a pointer rests on a link before hover prefetch
`prefetch.cacheFor`	`number \| string \| [string, string]`	`"30s"`	How long prefetched data stays fresh

The plugin also sets Ilha’s JSX import source unless your config sets one, pre-bundles the Ilha JSX runtimes, and de-duplicates ilha so the server and client share one instance. Dependencies that declare ilha as a dependency or peer get the same treatment.

Components

Export	Signature
`Link`	`(props: LinkProps) => View`; see the guide
`Form`	`({ form, method?, renderError?, children }) => View`

Hooks

Export	Returns
`useParams<T>()`	Route params; throws outside a Void page
`useShared<T>()`	Middleware-shared values; throws outside a Void page
`useNavigation()`	`NavigationState`; idle outside regular pages
`useRouter()`	`VoidRouter`; a server-safe stub outside regular pages
`usePageErrors()`	Validation errors the last action returned
`useForm(url, defaults, options?)`	`PageForm<T>`
`useIslandForm(defaults)`	`IslandForm<T>`

Other exports

action() and setActionRouter() are Void’s action client. VoidContext carries route state; read it through the hooks. The Deferred and InferProps types come from void.