# nativeWindowReferenceRuntime

A native window reference runtime record carrying schema, schemaVersion, capabilities, windows, events, and related state.

Last updated: 2026-09-09

Package: window.multi | Status: source-declared

Tags: cpu, method, multi, source-example, thing, window, window.multi, yeho

Describe multiple windows, input events, lifecycle, and capabilities with typed records.

```yh
external thing nativeWindowReferenceRuntime
```

- text schema: Stores schema as text.
- int schemaVersion: Stores schema version as int.
- nativeWindowCapabilitySet capabilities: Stores capabilities as nativeWindowCapabilitySet.
- list of nativeWindowReferenceState windows: Stores windows as list of nativeWindowReferenceState.
- list of nativeWindowEvent events: Stores events as list of nativeWindowEvent.
- int nextSequence: Stores next sequence as int.
- int lastTimestamp: Stores last timestamp as int.
- text diagnostic: Stores diagnostic as text.
- nativeWindowReferenceRuntime(text provider, int maximumWindows): Native window reference runtime.
- WindowIndex(text id) returns int: Window index.
- Record(text windowId, text kind, text detail, int timestampMicroseconds): Record.
- Create(nativeWindowSpec spec, bool providerAvailable, int timestampMicroseconds) returns bool: Create.
- Show(text id, bool visible, int timestampMicroseconds) returns bool: Show.
- Focus(text id, int timestampMicroseconds) returns bool: Focus.
- MoveResize(text id, int x, int y, int width, int height, int scalePercent, text monitorId, int timestampMicroseconds) returns bool: Move resize.
- SetMinimized(text id, bool minimized, int timestampMicroseconds) returns bool: Set minimized.
- RequestRedraw(text id, int timestampMicroseconds) returns bool: Request redraw.
- RouteKeyboard(nativeKeyboardRecord record) returns bool: Route keyboard.
- RoutePointer(nativePointerRecord record) returns bool: Route pointer.
- RequestClose(text id, int timestampMicroseconds) returns bool: Request close.
- CancelClose(text id, int timestampMicroseconds) returns bool: Cancel close.
- Close(text id, int timestampMicroseconds) returns bool: Close.
- TearDown(int timestampMicroseconds) returns int: Tear down.
- Describe() returns text: Describe.

## Use nativeWindowReferenceRuntime

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

Verification: type checked

```yh
using window.multi

// Describe multiple windows, input events, lifecycle, and capabilities with typed records.
nativeWindowReferenceRuntime sample = nativeWindowReferenceRuntime("provider", 1)
Console.Log(Text.From(sample.schema))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.WindowIndex

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Window index.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
int result = instance.WindowIndex(argument_id)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-WindowIndex-9 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.Record

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Record.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_windowId = "argument window Id"
text argument_kind = "argument kind"
text argument_detail = "argument detail"
int argument_timestampMicroseconds = 1
instance.Record(argument_windowId, argument_kind, argument_detail, argument_timestampMicroseconds)
Console.Log("Record completed")

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-Record-10 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.Create

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Create.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
nativeWindowSpec argument_spec = nativeWindowSpec("id", "owner Id", "Inventory", 1, 1, true)
bool argument_providerAvailable = true
int argument_timestampMicroseconds = 1
bool result = instance.Create(argument_spec, argument_providerAvailable, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-Create-11 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.Show

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Show.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
bool argument_visible = true
int argument_timestampMicroseconds = 1
bool result = instance.Show(argument_id, argument_visible, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-Show-12 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.Focus

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Focus.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
int argument_timestampMicroseconds = 1
bool result = instance.Focus(argument_id, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-Focus-13 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.MoveResize

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Move resize.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
int argument_x = 1
int argument_y = 1
int argument_width = 1
int argument_height = 1
int argument_scalePercent = 1
text argument_monitorId = "argument monitor Id"
int argument_timestampMicroseconds = 1
bool result = instance.MoveResize(argument_id, argument_x, argument_y, argument_width, argument_height, argument_scalePercent, argument_monitorId, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-MoveResize-14 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.SetMinimized

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Set minimized.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
bool argument_minimized = true
int argument_timestampMicroseconds = 1
bool result = instance.SetMinimized(argument_id, argument_minimized, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-SetMinimized-15 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.RequestRedraw

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Request redraw.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
int argument_timestampMicroseconds = 1
bool result = instance.RequestRedraw(argument_id, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-RequestRedraw-16 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.RouteKeyboard

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Route keyboard.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
nativeKeyboardRecord argument_record = nativeKeyboardRecord("window Id", 1, 1, "logical Key", "modifiers", true, 1, "device Id", "example")
bool result = instance.RouteKeyboard(argument_record)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-RouteKeyboard-17 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.RoutePointer

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Route pointer.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
nativePointerRecord argument_record = nativePointerRecord("window Id", 1, 1, "pointer Type", "buttons", 1, 1, 1, 1, 1, 1, 1, 1, true, true, true)
bool result = instance.RoutePointer(argument_record)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-RoutePointer-18 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.RequestClose

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Request close.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
int argument_timestampMicroseconds = 1
bool result = instance.RequestClose(argument_id, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-RequestClose-19 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.CancelClose

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Cancel close.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
int argument_timestampMicroseconds = 1
bool result = instance.CancelClose(argument_id, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-CancelClose-20 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.Close

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Close.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text argument_id = "argument id"
int argument_timestampMicroseconds = 1
bool result = instance.Close(argument_id, argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-Close-21 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.TearDown

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Tear down.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
int argument_timestampMicroseconds = 1
int result = instance.TearDown(argument_timestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-TearDown-22 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceRuntime.Describe

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Describe.
nativeWindowReferenceRuntime instance = nativeWindowReferenceRuntime("provider", 1)
text result = instance.Describe()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferenceruntime"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceRuntime/method-Describe-23 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

Source: yeho/packages/window/multi/10-reference-runtime.yh

AI training permission: https://demonhunterlabs.com/ai-use