ui · thing · Updated 2026-09-09

yuiRetainedFragmentCache

A yui retained fragment cache record carrying surfaceId, width, height, fragments, semanticFragments, and related state.

cpumethodsource-examplethinguiyeho

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

external thing yuiRetainedFragmentCache

Status: source-declared

Fields and methods (49)

text surfaceId: Stores surface id as text.
int width: Stores width as int.
int height: Stores height as int.
list of yuiRetainedOwnerFragment fragments: Stores fragments as list of yuiRetainedOwnerFragment.
list of yuiRetainedSemanticFragment semanticFragments: Stores semantic fragments as list of yuiRetainedSemanticFragment.
yuiRetainedKeyIndex ownerIndex: Stores owner index as yuiRetainedKeyIndex.
yuiRetainedKeyIndex semanticOwnerIndex: Stores semantic owner index as yuiRetainedKeyIndex.
yuiRetainedDependencyIndex dependencyIndex: Stores dependency index as yuiRetainedDependencyIndex.
int spatialColumns: Stores spatial columns as int.
int spatialRows: Stores spatial rows as int.
int spatialCellWidth: Stores spatial cell width as int.
int spatialCellHeight: Stores spatial cell height as int.
list of yuiRetainedSpatialBucket spatialBuckets: Stores spatial buckets as list of yuiRetainedSpatialBucket.
list of int spatialCellBuckets: Stores spatial cell buckets as list of int.
list of int spatialBucketEpochs: Stores spatial bucket epochs as list of int.
list of int spatialOwnerEpochs: Stores spatial owner epochs as list of int.
int spatialReplayEpoch: Stores spatial replay epoch as int.
int spatialMemberships: Stores spatial memberships as int.
int spatialMembershipWrites: Stores spatial membership writes as int.
list of yuiRetainedDamageRegion pendingDamage: Stores pending damage as list of yuiRetainedDamageRegion.
int touchedOwners: Stores touched owners as int.
int rebuiltOwners: Stores rebuilt owners as int.
int compositedOwners: Stores composited owners as int.
int touchedSemanticOwners: Stores touched semantic owners as int.
int frameOwnerIndexProbes: Stores frame owner index probes as int.
int frameSpatialCellProbes: Stores frame spatial cell probes as int.
int frameSpatialBucketsExamined: Stores frame spatial buckets examined as int.
int frameSpatialOwnersExamined: Stores frame spatial owners examined as int.
int frameReplayOwners: Stores frame replay owners as int.
list of yuiRetainedSemanticFragment pendingSemanticUpdates: Stores pending semantic updates as list of yuiRetainedSemanticFragment.
text reason: Stores reason as text.
text structuralDiagnostic: Stores structural diagnostic as text.
text diagnostic: Stores diagnostic as text.
yuiRetainedFragmentCache(text surfaceId, int width, int height): Yui retained fragment cache.
IndexOf(text ownerId) returns int: Index of. Complete example
SemanticIndexOf(text ownerId) returns int: Semantic index of. Complete example
SpatialBucketForCell(int cellX, int cellY, bool create) returns int: Spatial bucket for cell. Complete example
IndexFragmentSpatially(yuiRetainedOwnerFragment original fragment, int ownerIndex): Index fragment spatially. Complete example
RemoveFragmentSpatially(yuiRetainedOwnerFragment original fragment, int ownerIndex): Remove fragment spatially. Complete example
SpatialCoverageEqual(yuiRenderBounds leftBounds, yuiRenderBounds rightBounds) returns bool: Spatial coverage equal. Complete example
RegisterInitial(yuiRetainedOwnerFragment fragment) returns bool: Register initial. Complete example
RegisterInitialSemantic(yuiRetainedSemanticFragment fragment) returns bool: Register initial semantic. Complete example
BeginFrame(text reason) returns bool: Begin frame. Complete example
AddDamage(yuiRenderBounds requested): Add damage. Complete example
ApplyCandidate(yuiRetainedOwnerFragment candidate) returns bool: Apply candidate. Complete example
ApplySemanticCandidate(yuiRetainedSemanticFragment candidate) returns bool: Apply semantic candidate. Complete example
ReplaySpatially(yuiRetainedFramePlan original plan): Replay spatially. Complete example
IntersectsDamage(yuiRenderBounds bounds) returns bool: Intersects damage. Complete example
Plan() returns yuiRetainedFramePlan: Plan. Complete example

Use yuiRetainedFragmentCache

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.
yuiRetainedFragmentCache sample = yuiRetainedFragmentCache("surface Id", 1, 1)
Console.Log(Text.From(sample.surfaceId))

project.mech

manifestVersion = "2"
package = "api.example.ui__yuiretainedfragmentcache"
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"