# @getforma/core/navigation

Scoped native owner preparation, validation and lifecycle primitives used by router adapters.

This optional entry supplies native ownership. Application authors normally use createNativeAdapter with its generated bootstrap; it does not enable routing from core’s default entry.

Published declaration: [@getforma/core@3.2.0-rc.2](https://unpkg.com/@getforma/core@3.2.0-rc.2/dist/navigation.d.ts).

## Values and functions

### prepareInitialNativeOwners

Function export

```ts
declare function prepareInitialNativeOwners(registry: NativeIslandRegistry, owners: readonly NativeOwnerRoot[]): readonly NativeOwnerScope[];
```

Partition original document claims before the initial group activates.

Related declarations: [`NativeIslandRegistry`](/docs/3.2/api-navigation/#symbol-NativeIslandRegistry), [`NativeOwnerRoot`](/docs/3.2/api-navigation/#symbol-NativeOwnerRoot), [`NativeOwnerScope`](/docs/3.2/api-navigation/#symbol-NativeOwnerScope)

### prepareNativeOwner

Function export

```ts
declare function prepareNativeOwner(registry: NativeIslandRegistry, root: HTMLElement, stateJson: string, options?: {
    readonly outlet?: HTMLElement;
}): NativeOwnerScope;
```

Prepare an imported, detached owner with its own typed state envelope.

Related declarations: [`NativeIslandRegistry`](/docs/3.2/api-navigation/#symbol-NativeIslandRegistry), [`NativeOwnerScope`](/docs/3.2/api-navigation/#symbol-NativeOwnerScope)

### validateNativeOwnerTree

Function export

```ts
declare function validateNativeOwnerTree(owners: readonly NativeOwnerScope[]): void;
```

Validate the assembled linear owner branch before the router commits it.

Related declarations: [`NativeOwnerScope`](/docs/3.2/api-navigation/#symbol-NativeOwnerScope)

## Exported types

### NativeIslandRegistry

Type alias export

```ts
type NativeIslandRegistry = Record<string, (...args: never[]) => unknown>;
```



### NativeOwnerRoot

Interface export

```ts
interface NativeOwnerRoot {
    readonly root: HTMLElement;
    readonly outlet?: HTMLElement;
}
```



### NativeOwnerScope

Interface export

```ts
interface NativeOwnerScope extends NativeOwnerRoot {
    validate(): void;
    activate(): Promise<void>;
    dispose(): void;
}
```



Related declarations: [`NativeOwnerRoot`](/docs/3.2/api-navigation/#symbol-NativeOwnerRoot)

## Internal integration exports

### navigationHTML

Internal integration export; not an application-facing stability promise.

```ts
declare function navigationHTML(html: string): string;
```



## Other entry points

[@getforma/core](/docs/3.2/api-core/) · [@getforma/core/runtime](/docs/3.2/api-runtime/) · [@getforma/core/runtime-hardened](/docs/3.2/api-runtime-hardened/) · [@getforma/core/runtime-csp](/docs/3.2/api-runtime-csp/) · [@getforma/core/tc39](/docs/3.2/api-tc39/) · [@getforma/core/http](/docs/3.2/api-http/) · [@getforma/core/storage](/docs/3.2/api-storage/) · [@getforma/core/compiled](/docs/3.2/api-compiled/) · [JSX namespace](/docs/3.2/api-jsx/)