# yuiRetainedResourcePreparedCandidateBatchV1

A yui retained resource prepared candidate batch v1 object with the operations listed below.

Last updated: 2026-09-09

Package: ui | Status: source-declared

Tags: class, cpu, method, source-example, ui, validation, yeho

Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.

```yh
external class yuiRetainedResourcePreparedCandidateBatchV1
```

- yuiRetainedResourcePreparedCandidateBatchV1(yuiRetainedResourceStoreIdentityV1 storeIdentity, int preparedRevision, bool accepted, text diagnostic, list of yuiRetainedResourcePreparedAdmissionV1 items, int overlayIndexComparisons, int unrelatedBaseEntriesInspected, int baseEntriesCopied): Yui retained resource prepared candidate batch v1.
- Admitted() returns bool: Admitted.
- Revision() returns int: Revision.
- Count() returns int: Count.
- Validations() returns int: Validations.
- ExplicitComparisons() returns int: Explicit comparisons.
- PayloadComparisons() returns int: Payload comparisons.
- BaseIndexComparisons() returns int: Base index comparisons.
- OverlayIndexComparisons() returns int: Overlay index comparisons.
- UnrelatedBaseEntriesInspected() returns int: Unrelated base entries inspected.
- BaseEntriesCopied() returns int: Base entries copied.
- Diagnostic() returns text: Diagnostic.
- Consumed() returns bool: Consumed.
- MatchesStore(yuiRetainedResourceStoreIdentityV1 identity) returns bool: Matches store. Its identity parameter is private. Use the owning store commit operation; it performs this comparison internally.
- Consume(): Consume.
- MatchesInputs(list of yuiRetainedOwnerFragment fragments, list of yuiRetainedResourceDeltaV1 deltas) returns bool: Matches inputs.
- PreparedPlanAt(int index, yuiRetainedOwnerFragment fragment, yuiRetainedResourceDeltaV1 delta) returns yuiRetainedResourcePreflightV1: Prepared plan at.

## Preflight a HUD resource update

Ask the owning resource store to create a prepared result. Its internal identity is private; inspect admission and diagnostics before committing.

Verification: executed

```yh
using ui

yuiRetainedResourceStoreV1 store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment fragments = [fragment]
list of yuiRetainedResourceDeltaV1 deltas = [delta]
yuiRetainedResourcePreparedCandidateBatchV1 prepared = store.PrepareCandidateBatch(fragments, deltas, 0)
Console.Log(Text.From(prepared.Admitted()))
Console.Log(prepared.Diagnostic())

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

Executed backend: cpu-oracle

Observed output:

```text
false
retained resource candidate batch item 0: fragment player-panel requires 1..4096 commands
```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/complete --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.Admitted

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

Verification: type checked

```yh
using ui

// Admitted.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
bool result = instance.Admitted()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-Admitted-1 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.Revision

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

Verification: type checked

```yh
using ui

// Revision.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.Revision()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-Revision-2 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.Count

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

Verification: type checked

```yh
using ui

// Count.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.Count()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-Count-3 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.Validations

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

Verification: type checked

```yh
using ui

// Validations.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.Validations()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-Validations-4 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.ExplicitComparisons

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

Verification: type checked

```yh
using ui

// Explicit comparisons.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.ExplicitComparisons()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-ExplicitComparisons-5 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.PayloadComparisons

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

Verification: type checked

```yh
using ui

// Payload comparisons.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.PayloadComparisons()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-PayloadComparisons-6 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.BaseIndexComparisons

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

Verification: type checked

```yh
using ui

// Base index comparisons.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.BaseIndexComparisons()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-BaseIndexComparisons-7 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.OverlayIndexComparisons

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

Verification: type checked

```yh
using ui

// Overlay index comparisons.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.OverlayIndexComparisons()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-OverlayIndexComparisons-8 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.UnrelatedBaseEntriesInspected

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

Verification: type checked

```yh
using ui

// Unrelated base entries inspected.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.UnrelatedBaseEntriesInspected()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-UnrelatedBaseEntriesInspected-9 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.BaseEntriesCopied

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

Verification: type checked

```yh
using ui

// Base entries copied.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int result = instance.BaseEntriesCopied()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-BaseEntriesCopied-10 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.Diagnostic

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

Verification: type checked

```yh
using ui

// Diagnostic.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
text result = instance.Diagnostic()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-Diagnostic-11 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.Consumed

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

Verification: type checked

```yh
using ui

// Consumed.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
bool result = instance.Consumed()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-Consumed-12 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.MatchesStore

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

Verification: type checked

```yh
using ui

yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
// MatchesStore uses a private store identity. Let the owning store check it.
instance_store.CommitPreparedCandidateBatch(instance, instance_fragments, instance_deltas)
Console.Log("Store identity was checked by the owner")

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-MatchesStore-13 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.Consume

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

Verification: type checked

```yh
using ui

// Consume.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
instance.Consume()
Console.Log("Consume completed")

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-Consume-14 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.MatchesInputs

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

Verification: type checked

```yh
using ui

// Matches inputs.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
list of yuiRetainedOwnerFragment argument_fragments = []
list of yuiRetainedResourceDeltaV1 argument_deltas = []
bool result = instance.MatchesInputs(argument_fragments, argument_deltas)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-MatchesInputs-15 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRetainedResourcePreparedCandidateBatchV1.PreparedPlanAt

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

Verification: type checked

```yh
using ui

// Prepared plan at.
yuiRetainedResourceStoreV1 instance_store = CreateYuiRetainedResourceStoreV1("hud")
yuiRetainedOwnerFragment instance_fragment = yuiRetainedOwnerFragment("player-panel", 1, 0, yuiRenderBounds(0, 0, 100, 40), yuiRenderBounds(0, 0, 100, 40), yuiFragmentDependencySignature("layout", "paint", "resources", "motion", "composite", "example"), "example")
yuiRetainedResourceDeltaV1 instance_delta = yuiRetainedResourceDeltaV1("hud")
list of yuiRetainedOwnerFragment instance_fragments = [instance_fragment]
list of yuiRetainedResourceDeltaV1 instance_deltas = [instance_delta]
yuiRetainedResourcePreparedCandidateBatchV1 instance = instance_store.PrepareCandidateBatch(instance_fragments, instance_deltas, 0)
int argument_index = 1
yuiRetainedOwnerFragment argument_fragment = yuiRetainedOwnerFragment("owner Id", 1, 1, yuiRenderBounds(1, 1, 1, 1), yuiRenderBounds(1, 1, 1, 1), yuiFragmentDependencySignature("layout Key", "paint Key", "resource Key", "motion Key", "composite Key", "example"), "example")
yuiRetainedResourceDeltaV1 argument_delta = yuiRetainedResourceDeltaV1("surface Id")
instance.PreparedPlanAt(argument_index, argument_fragment, argument_delta)
Console.Log("PreparedPlanAt completed")

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRetainedResourcePreparedCandidateBatchV1/method-PreparedPlanAt-16 --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/ui/render-60-retained-resource-snapshots.yh

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