{"id":"ui--yuiCoreControlSpec","name":"yuiCoreControlSpec","owner":"yeho","package":"ui","kind":"thing","signature":"external thing yuiCoreControlSpec","description":"A yui core control spec record carrying kind, authoringTag, metadata, interactive, focusable, and related state.","context":"Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.","parameters":[],"returns":"void","members":[{"name":"kind","kind":"field","type":"text","description":"Stores kind as text.","signature":"text kind","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"authoringTag","kind":"field","type":"text","description":"Stores authoring tag as text.","signature":"text authoringTag","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"metadata","kind":"field","type":"yuiComponentMetadata","description":"Stores metadata as yuiComponentMetadata.","signature":"yuiComponentMetadata metadata","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"interactive","kind":"field","type":"bool","description":"Stores interactive as bool.","signature":"bool interactive","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"focusable","kind":"field","type":"bool","description":"Stores focusable as bool.","signature":"bool focusable","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"keyboardContract","kind":"field","type":"text","description":"Stores keyboard contract as text.","signature":"text keyboardContract","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"pointerContract","kind":"field","type":"text","description":"Stores pointer contract as text.","signature":"text pointerContract","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"accessibilityRole","kind":"field","type":"text","description":"Stores accessibility role as text.","signature":"text accessibilityRole","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"accessibilityActions","kind":"field","type":"text","description":"Stores accessibility actions as text.","signature":"text accessibilityActions","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"valueModel","kind":"field","type":"text","description":"Stores value model as text.","signature":"text valueModel","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"layoutBehavior","kind":"field","type":"text","description":"Stores layout behavior as text.","signature":"text layoutBehavior","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"slots","kind":"field","type":"text","description":"Stores slots as text.","signature":"text slots","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"applicableStates","kind":"field","type":"text","description":"Stores applicable states as text.","signature":"text applicableStates","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"stateStyles","kind":"field","type":"list of yuiCoreControlStateStyle","description":"Stores state styles as list of yuiCoreControlStateStyle.","signature":"list of yuiCoreControlStateStyle stateStyles","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"source","kind":"field","type":"text","description":"Stores source as text.","signature":"text source","tags":["thing","field","ui"],"updated":"2026-09-09"},{"name":"yuiCoreControlSpec","kind":"constructor","parameters":[{"name":"kind","type":"text","description":"Kind."},{"name":"authoringTag","type":"text","description":"Authoring tag."},{"name":"metadata","type":"yuiComponentMetadata","description":"Metadata."},{"name":"interactive","type":"bool","description":"Interactive."},{"name":"focusable","type":"bool","description":"Focusable."},{"name":"keyboardContract","type":"text","description":"Keyboard contract."},{"name":"pointerContract","type":"text","description":"Pointer contract."},{"name":"accessibilityRole","type":"text","description":"Accessibility role."},{"name":"accessibilityActions","type":"text","description":"Accessibility actions."},{"name":"valueModel","type":"text","description":"Value model."},{"name":"layoutBehavior","type":"text","description":"Layout behavior."},{"name":"slots","type":"text","description":"Slots."},{"name":"applicableStates","type":"text","description":"Applicable states."},{"name":"source","type":"text","description":"Source."}],"returns":"void","signature":"yuiCoreControlSpec(text kind, text authoringTag, yuiComponentMetadata metadata, bool interactive, bool focusable, text keyboardContract, text pointerContract, text accessibilityRole, text accessibilityActions, text valueModel, text layoutBehavior, text slots, text applicableStates, text source)","description":"Yui core control spec.","tags":["thing","constructor","ui"],"updated":"2026-09-09"},{"name":"StateIndex","kind":"method","parameters":[{"name":"state","type":"text","description":"State."}],"returns":"int","signature":"StateIndex(text state) returns int","description":"State index.","tags":["thing","method","ui"],"exampleId":"method-StateIndex-16","updated":"2026-09-09"},{"name":"SupportsState","kind":"method","parameters":[{"name":"state","type":"text","description":"State."}],"returns":"bool","signature":"SupportsState(text state) returns bool","description":"Supports state.","tags":["thing","method","ui"],"exampleId":"method-SupportsState-17","updated":"2026-09-09"},{"name":"AddStateStyle","kind":"method","parameters":[{"name":"style","type":"yuiCoreControlStateStyle","description":"Style."}],"returns":"bool","signature":"AddStateStyle(yuiCoreControlStateStyle style) returns bool","description":"Add state style.","tags":["thing","method","ui"],"exampleId":"method-AddStateStyle-18","updated":"2026-09-09"},{"name":"ResolveState","kind":"method","parameters":[{"name":"state","type":"text","description":"State."}],"returns":"yuiCoreControlStateStyle","signature":"ResolveState(text state) returns yuiCoreControlStateStyle","description":"Resolve state.","tags":["thing","method","ui"],"exampleId":"method-ResolveState-19","updated":"2026-09-09"},{"name":"ValidationIssue","kind":"method","parameters":[],"returns":"text","signature":"ValidationIssue() returns text","description":"Validation issue.","tags":["thing","method","ui"],"exampleId":"method-ValidationIssue-20","updated":"2026-09-09"},{"name":"ValidateTheme","kind":"method","parameters":[{"name":"theme","type":"yuiThemeDefinition","description":"Theme."}],"returns":"text","signature":"ValidateTheme(yuiThemeDefinition theme) returns text","description":"Validate theme.","tags":["thing","method","ui"],"exampleId":"method-ValidateTheme-21","updated":"2026-09-09"},{"name":"RenderReport","kind":"method","parameters":[],"returns":"text","signature":"RenderReport() returns text","description":"Render report.","tags":["thing","method","ui"],"exampleId":"method-RenderReport-22","updated":"2026-09-09"}],"tags":["cpu","method","source-example","thing","ui","yeho"],"updated":"2026-09-09","source":{"repository":"yeho","path":"packages/ui/controls-00-definitions.yh","line":52,"sha256":"fa1e7bb5a6ce717390a9aa5dfab81a5a651d0ff4db12cd5c3b79c09ec3d26b60"},"status":"source-declared","notes":["Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup."],"examples":[{"id":"usage","title":"Use yuiCoreControlSpec","description":"A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.","code":"using ui\n\n// Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.\nyuiCoreControlSpec sample = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\nConsole.Log(Text.From(sample.kind))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","source-example"],"verification":"type checked","run":"cpu-oracle","sha256":"d05ff0640e9aac787c9595ea9c30175427ba893e2afe3d168a63abfb11fba36c","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-StateIndex-16","title":"yuiCoreControlSpec.StateIndex","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using ui\n\n// State index.\nyuiCoreControlSpec instance = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\ntext argument_state = \"argument state\"\nint result = instance.StateIndex(argument_state)\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"ffb554693dc258beebc52e18582fe7cde5ca6562f2a420dd83a082cf7f98fddb","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-SupportsState-17","title":"yuiCoreControlSpec.SupportsState","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using ui\n\n// Supports state.\nyuiCoreControlSpec instance = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\ntext argument_state = \"argument state\"\nbool result = instance.SupportsState(argument_state)\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"ace708c955fd8d10ed3992743e708b49b996f4eeb6afbba22eeaa36d179fc1a1","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-AddStateStyle-18","title":"yuiCoreControlSpec.AddStateStyle","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using ui\n\n// Add state style.\nyuiCoreControlSpec instance = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\nyuiCoreControlStateStyle argument_style = yuiCoreControlStateStyle(\"state\", \"fill Role\", \"border Role\", \"content Role\", \"icon Role\", \"non Color Cue\", \"motion Role\", 1)\nbool result = instance.AddStateStyle(argument_style)\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"55aa3b6b2f7c80c46bf852019ada40f8799e91fb62a7bc44f5630a8a9c27ab8b","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-ResolveState-19","title":"yuiCoreControlSpec.ResolveState","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using ui\n\n// Resolve state.\nyuiCoreControlSpec instance = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\ntext argument_state = \"argument state\"\nyuiCoreControlStateStyle result = instance.ResolveState(argument_state)\nConsole.Log(\"Inspect result in your debugger\")\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"e3a36e3166de2c407f4dfe811b5bb12e65a9be58a9e4d06c29bb0a1f4e9f0257","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-ValidationIssue-20","title":"yuiCoreControlSpec.ValidationIssue","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using ui\n\n// Validation issue.\nyuiCoreControlSpec instance = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\ntext result = instance.ValidationIssue()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"29da600f1400db2102d517a1f639f43f7ca1f5da380598a179029f4d8d0580b4","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-ValidateTheme-21","title":"yuiCoreControlSpec.ValidateTheme","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using ui\n\n// Validate theme.\nyuiCoreControlSpec instance = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\nyuiThemeDefinition argument_theme = yuiThemeDefinition(\"id\", \"display Name\", \"mode\", \"example\")\ntext result = instance.ValidateTheme(argument_theme)\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"e499528b019f6a44a13d06076a7a491d3a926b5e5d12a4a081ab580a8724ae25","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-RenderReport-22","title":"yuiCoreControlSpec.RenderReport","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using ui\n\n// Render report.\nyuiCoreControlSpec instance = yuiCoreControlSpec(\"kind\", \"authoring Tag\", yuiComponentMetadata(\"Nova\", \"role\", \"property Schema\", \"child Rule\", \"defaults\", \"example\", \"design Label\", true), true, true, \"keyboard Contract\", \"pointer Contract\", \"accessibility Role\", \"accessibility Actions\", \"value Model\", \"layout Behavior\", \"slots\", \"applicable States\", \"example\")\ntext result = instance.RenderReport()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.ui__yuicorecontrolspec\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"graphics.image\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/image\"\n\n[[dependencies]]\npackage = \"graphics.text\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/graphics/text\"\n\n[[dependencies]]\npackage = \"host.ui_services\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/host/ui_services\"\n\n[[dependencies]]\npackage = \"ui\"\nversion = \"0.2.0\"\npath = \"../../../yeho/packages/ui\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"ca0dad918a68b5596891c2ff7e8b648c2889d87167323b199fbeac5ee637e0f2","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null}],"searchTerms":["kind","authoringTag","metadata","interactive","focusable","keyboardContract","pointerContract","accessibilityRole","accessibilityActions","valueModel","layoutBehavior","slots","applicableStates","stateStyles","source","yuiCoreControlSpec","StateIndex","SupportsState","AddStateStyle","ResolveState","ValidationIssue","ValidateTheme","RenderReport"],"url":"https://demonhunterlabs.com/academy/api?item=ui--yuiCoreControlSpec","json":"https://demonhunterlabs.com/reference/items/ui--yuiCoreControlSpec.json","markdown":"https://demonhunterlabs.com/reference/text/ui--yuiCoreControlSpec.md"}