ui · thing ·

yuiInvalidationTracker

A yui invalidation tracker record carrying surfaceId, surfaceArea, elements, invalidatedArea, generation, and related state.

cpumethodsource-examplethinguiyeho

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

external thing yuiInvalidationTracker

Status: source-declared

Fields and methods (15)
text surfaceId
Stores surface id as text.
int surfaceArea
Stores surface area as int.
list of yuiRenderElementState elements
Stores elements as list of yuiRenderElementState.
int invalidatedArea
Stores invalidated area as int.
int generation
Stores generation as int.
text lastReason
Stores last reason as text.
text diagnostic
Stores diagnostic as text.
yuiInvalidationTracker(text surfaceId, int width, int height)
Yui invalidation tracker.
IndexOf(text id) returns int
Index of. Complete example
AddElement(yuiRenderElementState element) returns bool
Add element. Complete example
MarkElement(text id, bool measure, bool layout, bool paint) returns bool
Mark element. Complete example
MarkAncestors(text id, bool layout, bool paint) returns bool
Mark ancestors. Complete example
Invalidate(text id, text scope, text reason) returns bool
Invalidate. Complete example
ConsumeFrame() returns yuiPartialRebuildReport
Consume frame. Complete example
ElementReport(text id) returns text
Element report. Complete example

Use yuiInvalidationTracker

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

cpu · source-example · type checked

using ui

// Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.
yuiInvalidationTracker sample = yuiInvalidationTracker("surface Id", 1, 1)
Console.Log(Text.From(sample.surfaceId))
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"

yuiInvalidationTracker.IndexOf

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

cpu · method · source-example · type checked

using ui

// Index of.
yuiInvalidationTracker instance = yuiInvalidationTracker("surface Id", 1, 1)
text argument_id = "argument id"
int result = instance.IndexOf(argument_id)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"

yuiInvalidationTracker.AddElement

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

cpu · method · source-example · type checked

using ui

// Add element.
yuiInvalidationTracker instance = yuiInvalidationTracker("surface Id", 1, 1)
yuiRenderElementState argument_element = yuiRenderElementState("id", "parent Id", yuiRenderBounds(1, 1, 1, 1))
bool result = instance.AddElement(argument_element)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"

yuiInvalidationTracker.MarkElement

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

cpu · method · source-example · type checked

using ui

// Mark element.
yuiInvalidationTracker instance = yuiInvalidationTracker("surface Id", 1, 1)
text argument_id = "argument id"
bool argument_measure = true
bool argument_layout = true
bool argument_paint = true
bool result = instance.MarkElement(argument_id, argument_measure, argument_layout, argument_paint)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"

yuiInvalidationTracker.MarkAncestors

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

cpu · method · source-example · type checked

using ui

// Mark ancestors.
yuiInvalidationTracker instance = yuiInvalidationTracker("surface Id", 1, 1)
text argument_id = "argument id"
bool argument_layout = true
bool argument_paint = true
bool result = instance.MarkAncestors(argument_id, argument_layout, argument_paint)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"

yuiInvalidationTracker.Invalidate

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

cpu · method · source-example · type checked

using ui

// Invalidate.
yuiInvalidationTracker instance = yuiInvalidationTracker("surface Id", 1, 1)
text argument_id = "argument id"
text argument_scope = "argument scope"
text argument_reason = "argument reason"
bool result = instance.Invalidate(argument_id, argument_scope, argument_reason)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"

yuiInvalidationTracker.ConsumeFrame

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

cpu · method · source-example · type checked

using ui

// Consume frame.
yuiInvalidationTracker instance = yuiInvalidationTracker("surface Id", 1, 1)
yuiPartialRebuildReport result = instance.ConsumeFrame()
Console.Log("Inspect result in your debugger")
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"

yuiInvalidationTracker.ElementReport

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

cpu · method · source-example · type checked

using ui

// Element report.
yuiInvalidationTracker instance = yuiInvalidationTracker("surface Id", 1, 1)
text argument_id = "argument id"
text result = instance.ElementReport(argument_id)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.ui__yuiinvalidationtracker"
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"
Notes and source

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

yeho/packages/ui/render-30-invalidation.yh:59