[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72S7HCAG39JQV9A3CZ4MP0M":3,"skill-same:01M72S7HCAG39JQV9A3CZ4MP0M":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M72S7HCAG39JQV9A3CZ4MP0M","fs-skia-controls-host",null,"Maintainer-facing guide to the FS.Skia.UI.Controls.Elmish interactive-host seam — how runInteractiveApp drives the retained render structure each frame (RetainedRender.step over the keyed diff), advances per-identity animation clocks from an injected Tick delta, stamps runtime visual state pre-reconcile, routes keys focus-first through routeFocusedKey, and resolves pointer hits to a stable identity via retainedHitTest. Use when reading or extending the live controls host loop, the per-frame retained-state\u002Fclock\u002Fvisual-state wiring, or the key\u002Fpointer routing seam.","EHotwagner\u002FFS-Skia-UI","EHotwagner","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1645484?v=4","01M72S7CTBDPQDQHQJKKHY87K9","01M72S7CVFD0JN82RVX21NFEVC",2,"MIT","https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Ffs-skia-controls-host\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: fs-skia-controls-host\ndescription: Maintainer-facing guide to the FS.Skia.UI.Controls.Elmish interactive-host seam — how runInteractiveApp drives the retained render structure each frame (RetainedRender.step over the keyed diff), advances per-identity animation clocks from an injected Tick delta, stamps runtime visual state pre-reconcile, routes keys focus-first through routeFocusedKey, and resolves pointer hits to a stable identity via retainedHitTest. Use when reading or extending the live controls host loop, the per-frame retained-state\u002Fclock\u002Fvisual-state wiring, or the key\u002Fpointer routing seam.\ncompatibility: F# net10.0; FS.Skia.UI.Controls.Elmish package. Public entry `ControlsElmish.runInteractiveApp` (feature 085); the per-frame retained wiring is `module internal RetainedRender` (Controls) + internal host seams (`routeFocusedKey`, `resolveFocus`) reached via InternalsVisibleTo. Zero public-surface delta from the 096–103 roadmap — `runInteractiveApp`'s signature is unchanged.\nmetadata:\n  author: fs-skia-ui\n  source: specs\u002F104-refresh-live-path-skills\u002Fplan.md\n---\n\n# fs-skia-controls-host\n\nThe **interactive-host seam** for `FS.Skia.UI.Controls.Elmish`: the live loop that drives a\n`Control\u003C'msg>` tree to a window, frame by frame, over the wired keyed reconciler. This is the\n**maintainer-facing** counterpart to the consumer-facing [[fs-skia-viewer-host]] — it documents what\n`runInteractiveApp` does *internally* each frame (the retained structure it holds, the animation\nclocks it advances, the visual state it stamps, the keys and pointers it routes), not just the\nhost record a consumer fills in.\n\nIt exists because the R1–R6 live-path roadmap (096–103) layered real per-frame behavior onto the\n091 wiring — incremental layout, an injected-delta animation clock, a visual-state cross-fade — and\nthat behavior lives at the `Controls.Elmish` host edge, not in any single control. A maintainer\ntouching the host loop needs one place that maps it.\n\n## Scope \u002F when to use\n\nUse this skill when:\n\n- You are reading or extending `src\u002FControls.Elmish\u002FControlsElmish.fs(i)` — the `runInteractiveApp`\n  loop, `routeFocusedKey`, `resolveFocus`, or the per-frame `RetainedRender.step` call.\n- You need to know **where** per-control state (focus, text, animation clock) lives across frames and\n  how it survives a positional shift (the interpreter-edge ref state keyed by stable `RetainedId`).\n- You are wiring a new per-frame concern (a clock, a visual-state source, a key\u002Fpointer route) and\n  need the order: assemble visual state → stamp pre-reconcile → diff → advance clocks → sample on\n  paint.\n- You are tracing why a key reaches (or doesn't reach) a focused control vs. `host.MapKey`, or why a\n  pointer click resolves to a particular control identity.\n\nDo **not** use this for *consumer* host authoring (filling in `InteractiveAppHost`, the\npreview-vs-tree decision, the windowed-fullscreen blur caveat) — that is [[fs-skia-viewer-host]].\nDo **not** use it for the diff invariants themselves — that is [[fs-skia-reconciliation]]. This skill\nis the **host that drives** the retained structure those two describe.\n\n## Driven-library API (the host seam, `ControlsElmish.fsi`)\n\nThe live entry is **public**; the per-frame retained wiring is **internal** (reached by the adapter\nand its tests via `InternalsVisibleTo`). Read `src\u002FControls.Elmish\u002FControlsElmish.fsi` and\n`src\u002FControls\u002FRetainedRender.fsi` for the authoritative signatures.\n\n- **`runInteractiveApp : ViewerOptions -> InteractiveAppHost\u003C'model,'msg> -> Result\u003CViewerLaunchOutcome, ViewerRunFailure>`**\n  (feature 085) — the live host entry. The `InteractiveAppHost` record carries\n  `Init \u002F Update \u002F View \u002F Theme \u002F MapKey \u002F MapPointer \u002F Tick \u002F Diagnostics`: `Init : unit ->\n  'model * ViewerEffect list`, `Update : 'msg -> 'model -> 'model * ViewerEffect list`,\n  `View : Size -> 'model -> Control\u003C'msg>` (size-aware), `Theme`, `MapKey : ViewerKey -> bool ->\n  'msg option`, `MapPointer : PointerInteraction -> 'msg option`, `Tick : TimeSpan -> 'msg option`.\n- **`RetainedRender.step : theme -> size -> prev:RetainedRender\u003C'msg> -> next:Control\u003C'msg> -> RetainedRenderStep\u003C'msg>`**\n  \u002F **`RetainedRender.init`** (Controls, `module internal`) — produce each frame from the retained\n  `prev` and the next lowered tree by `Reconcile.diff`-ing and reusing fragments. The\n  `RetainedRender\u003C'msg>` the host holds carries `Root`, `NextId`, `StateByIdentity : Map\u003CRetainedId,\n  RetainedUiState>`, `Theme` (the fragment-reuse key), and `Layout : LayoutResult` (the previous\n  frame's bounds cache).\n- **`RetainedRender.advance` \u002F `updateClockForState` \u002F `sampleOnPaint`** — advance a per-identity\n  `AnimationClock` by an injected delta, decide its start\u002Fretarget\u002Fadvance\u002Fdrop on a visual-state\n  change, and composite the cross-fade on paint.\n- **`ControlRuntime.applyRuntimeVisualState : model -> control -> control`** (internal) — stamp each\n  control's derived `VisualState` onto the lowered tree **pre-reconcile**.\n- **`routeFocusedKey` (internal)** — route a delivered key to the focused control over the retained\n  tree; **`resolveFocus` \u002F `RetainedRender.retainedHitTest` (internal)** — resolve a point to a\n  stable `RetainedId`.\n\n### What the host does each frame\n\n1. **Assemble + stamp visual state.** Build a `ControlRuntimeModel` from the live pointer \u002F focus\n   state and stamp it onto the lowered `host.View size model` tree with\n   `ControlRuntime.applyRuntimeVisualState` — **before** the diff runs (byte-identical at `Normal`,\n   feature 096 \u002F R1).\n2. **Diff + reuse.** Hand the stamped tree to `RetainedRender.step`, which `Reconcile.diff`-s it\n   against the retained `prev`, reuses unchanged subtrees' cached fragments and the previous\n   `Layout` bounds (incremental re-measure, 097\u002F101 \u002F R2), and re-keys per-control state to the\n   stable `RetainedId` so it survives a positional shift (091 \u002F E2).\n3. **Advance clocks + sample.** On `host.Tick delta`, advance each identity's `AnimationClock` by the\n   **injected** delta (`RetainedRender.advance`; no wall-clock), then paint composites the active\n   clock's cross-fade with `RetainedRender.sampleOnPaint` (099\u002F103 \u002F R4\u002FR6). A settled\u002Fabsent clock\n   paints byte-identically to the static render.\n4. **Route input.** Keys go focus-first (text seam → `routeFocusedKey` → `host.MapKey`); pointer\n   samples hit-test to a stable identity and dispatch the hit control's authored bindings (or\n   `host.MapPointer`).\n\n## Runnable example — fill the host, run it\n\nThe consumer surface is just the `InteractiveAppHost` record; the retained wiring is automatic.\n\n```fsharp\nopen System\nopen FS.Skia.UI.Scene\nopen FS.Skia.UI.Controls\nopen FS.Skia.UI.Controls.Elmish\nopen FS.Skia.UI.SkiaViewer\n\nlet host : InteractiveAppHost\u003CModel, Msg> =\n    { Init = fun () -> initModel, []\n      Update = fun msg model -> update msg model              \u002F\u002F pure: 'model -> 'model * ViewerEffect list\n      View = fun (size: Size) model -> view size model        \u002F\u002F size-aware: returns Control\u003C'msg>\n      Theme = Theme.light\n      MapKey = fun key isDown -> mapKey key isDown            \u002F\u002F last-resort: only keys no focused control consumed\n      MapPointer = fun interaction -> mapPointer interaction  \u002F\u002F fallback for unconsumed hits\n      Tick = fun (delta: TimeSpan) -> None                    \u002F\u002F delta drives the per-identity AnimationClock\n      Diagnostics = Viewer.defaultDiagnostics }\n\n\u002F\u002F runInteractiveApp holds the RetainedRender in interpreter-edge ref state and produces every\n\u002F\u002F frame via RetainedRender.step — the consumer record above is unchanged from 085 (096–103 added\n\u002F\u002F no field; the live behavior rides the internal seam).\nControlsElmish.runInteractiveApp { Title = \"App\"; InitialSize = { Width = 1024; Height = 768 } } host\n```\n\n```fsharp\n\u002F\u002F Maintainer view of the per-frame seam (internal symbols, reached via InternalsVisibleTo):\n\u002F\u002F 1. stamp runtime visual state pre-reconcile (096):\nlet stamped = ControlRuntime.applyRuntimeVisualState runtimeModel (host.View size model)\n\u002F\u002F 2. diff + reuse fragments\u002Fbounds, carrying StateByIdentity\u002FLayout\u002FTheme (091\u002F097\u002F101):\nlet frame   = RetainedRender.step host.Theme size prev stamped\n\u002F\u002F 3. on Tick, advance each identity's clock by the INJECTED delta (099 — no wall-clock):\nlet clock'  = RetainedRender.advance delta clock\n\u002F\u002F 4. route a key focus-first; an unconsumed key falls through to host.MapKey:\nlet retained', runtimeMsgs, productMsgs = ControlsElmish.routeFocusedKey retained focused order key shift\n\u002F\u002F 5. resolve a pointer to a stable identity (no unkeyed-sibling collision, 092):\nlet hit     = RetainedRender.retainedHitTest x y prev\n```\n\n## Key & pointer routing (the seam's two edges)\n\n- **Keys are routed focus-first** (feature 094 \u002F E4). Each native key is offered to the E1\n  `routeFocusedText` text seam (a focused TEXT control's printable keys), then to internal\n  `routeFocusedKey retained focused order key shift`, which reads the focused control's\n  `KeyboardOperation` and applies `Focus.route`: `Activate` fires the focused control's authored\n  activation bindings once; `Navigate` steps its value\u002Fselection (a slider's arrow); `Traverse`\n  moves focus via `Focus.traverse`; `Fallthrough` yields no message — and **only then** the host\n  consults `host.MapKey`. So `MapKey` is the last resort for keys no focused control and no traversal\n  consumed.\n- **Pointers resolve to a stable identity** (feature 092 \u002F FR-004). `RetainedRender.retainedHitTest`\n  (via the adapter's `resolveFocus`) returns the deepest retained node whose cached `Fragment.Box`\n  contains the point — a **per-node** identity with no unkeyed-same-kind-sibling collision (unlike\n  the `ControlId` `hitTest` path). A press sets focus to the focusable control under it (so a later\n  key reaches it); the hit control's authored `EventBindings` win, with `host.MapPointer` the\n  fallback for unconsumed interactions.\n\n## Persistent problems\n\nWhen the host loop, a clock, or a route will not behave after reasonable in-repo attempts,\n**official online docs first** (the F#\u002F.NET docs and the driven library's own documentation — Elmish\nMVU for the update\u002Feffect boundary, React reconciliation\u002Fkeys as the keyed-diff prior art), then\ncommunity sources (forums, issue trackers, changelogs). Record findings and resolving links in\n`specs\u002F\u003Cfeature>\u002Ffeedback\u002F` and, for durable lessons, in this skill's **Sources** line. Offline,\nrecord \"research blocked — \u003Cwhy>\" rather than hard-failing the phase.\n\n## Related\n\n- [[fs-skia-reconciliation]] — the keyed VDOM diff and the retained `RetainedRender` structure this\n  host drives each frame (`step`, the bounds cache, the animation clock, `sampleOnPaint`).\n- [[fs-skia-viewer-host]] — the **consumer-facing** counterpart: filling in `InteractiveAppHost`,\n  the preview-vs-tree (`Control.render` vs `Control.renderTree`) distinction, the windowed-fullscreen\n  blur caveat, and keyboard warm-up.\n- [[fs-skia-ui-widgets]] — building the `Control\u003C'msg>` tree (and its E1–E5 capabilities) this host\n  renders and routes input to.\n- [[fs-skia-elmish]] — the MVU `init`\u002F`update`\u002F`Effect` wiring the host's interpreter edge folds.\n\n## Sources \u002F links\n\n- Feature 085 (interactive host) \u002F 091–103 (live retained path): `specs\u002F085-*\u002Fplan.md`,\n  `specs\u002F104-refresh-live-path-skills\u002Fplan.md`; signatures in `src\u002FControls.Elmish\u002FControlsElmish.fsi`\n  and `src\u002FControls\u002FRetainedRender.fsi`.\n- Elmish (the MVU model the host loop follows): https:\u002F\u002Felmish.github.io\u002Felmish\u002F\n- React reconciliation & keys (keyed-VDOM-diff prior art the retained path builds on):\n  https:\u002F\u002Freact.dev\u002Flearn\u002Fpreserving-and-resetting-state\n- F#\u002F.NET docs: https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fdotnet\u002Ffsharp\u002F\n","# fs-skia-controls-host\n\nThe **interactive-host seam** for `FS.Skia.UI.Controls.Elmish`: the live loop that drives a\n`Control\u003C'msg>` tree to a window, frame by frame, over the wired keyed reconciler. This is the\n**maintainer-facing** counterpart to the consumer-facing [[fs-skia-viewer-host]] — it documents what\n`runInteractiveApp` does *internally* each frame (the retained structure it holds, the animation\nclocks it advances, the visual state it stamps, the keys and pointers it routes), not just the\nhost record a consumer fills in.\n\nIt exists because the R1–R6 live-path roadmap (096–103) layered real per-frame behavior onto the\n091 wiring — incremental layout, an injected-delta animation clock, a visual-state cross-fade — and\nthat behavior lives at the `Controls.Elmish` host edge, not in any single control. A maintainer\ntouching the host loop needs one place that maps it.\n\n## Scope \u002F when to use\n\nUse this skill when:\n\n- You are reading or extending `src\u002FControls.Elmish\u002FControlsElmish.fs(i)` — the `runInteractiveApp`\n  loop, `routeFocusedKey`, `resolveFocus`, or the per-frame `RetainedRender.step` call.\n- You need to know **where** per-control state (focus, text, animation clock) lives across frames and\n  how it survives a positional shift (the interpreter-edge ref state keyed by stable `RetainedId`).\n- You are wiring a new per-frame concern (a clock, a visual-state source, a key\u002Fpointer route) and\n  need the order: assemble visual state → stamp pre-reconcile → diff → advance clocks → sample on\n  paint.\n- You are tracing why a key reaches (or doesn't reach) a focused control vs. `host.MapKey`, or why a\n  pointer click resolves to a particular control identity.\n\nDo **not** use this for *consumer* host authoring (filling in `InteractiveAppHost`, the\npreview-vs-tree decision, the windowed-fullscreen blur caveat) — that is [[fs-skia-viewer-host]].\nDo **not** use it for the diff invariants themselves — that is [[fs-skia-reconciliation]]. This skill\nis the **host that drives** the retained structure those two describe.\n\n## Driven-library API (the host seam, `ControlsElmish.fsi`)\n\nThe live entry is **public**; the per-frame retained wiring is **internal** (reached by the adapter\nand its tests via `InternalsVisibleTo`). Read `src\u002FControls.Elmish\u002FControlsElmish.fsi` and\n`src\u002FControls\u002FRetainedRender.fsi` for the authoritative signatures.\n\n- **`runInteractiveApp : ViewerOptions -> InteractiveAppHost\u003C'model,'msg> -> Result\u003CViewerLaunchOutcome, ViewerRunFailure>`**\n  (feature 085) — the live host entry. The `InteractiveAppHost` record carries\n  `Init \u002F Update \u002F View \u002F Theme \u002F MapKey \u002F MapPointer \u002F Tick \u002F Diagnostics`: `Init : unit ->\n  'model * ViewerEffect list`, `Update : 'msg -> 'model -> 'model * ViewerEffect list`,\n  `View : Size -> 'model -> Control\u003C'msg>` (size-aware), `Theme`, `MapKey : ViewerKey -> bool ->\n  'msg option`, `MapPointer : PointerInteraction -> 'msg option`, `Tick : TimeSpan -> 'msg option`.\n- **`RetainedRender.step : theme -> size -> prev:RetainedRender\u003C'msg> -> next:Control\u003C'msg> -> RetainedRenderStep\u003C'msg>`**\n  \u002F **`RetainedRender.init`** (Controls, `module internal`) — produce each frame from the retained\n  `prev` and the next lowered tree by `Reconcile.diff`-ing and reusing fragments. The\n  `RetainedRender\u003C'msg>` the host holds carries `Root`, `NextId`, `StateByIdentity : Map\u003CRetainedId,\n  RetainedUiState>`, `Theme` (the fragment-reuse key), and `Layout : LayoutResult` (the previous\n  frame's bounds cache).\n- **`RetainedRender.advance` \u002F `updateClockForState` \u002F `sampleOnPaint`** — advance a per-identity\n  `AnimationClock` by an injected delta, decide its start\u002Fretarget\u002Fadvance\u002Fdrop on a visual-state\n  change, and composite the cross-fade on paint.\n- **`ControlRuntime.applyRuntimeVisualState : model -> control -> control`** (internal) — stamp each\n  control's derived `VisualState` onto the lowered tree **pre-reconcile**.\n- **`routeFocusedKey` (internal)** — route a delivered key to the focused control over the retained\n  tree; **`resolveFocus` \u002F `RetainedRender.retainedHitTest` (internal)** — resolve a point to a\n  stable `RetainedId`.\n\n### What the host does each frame\n\n1. **Assemble + stamp visual state.** Build a `ControlRuntimeModel` from the live pointer \u002F focus\n   state and stamp it onto the lowered `host.View size model` tree with\n   `ControlRuntime.applyRuntimeVisualState` — **before** the diff runs (byte-identical at `Normal`,\n   feature 096 \u002F R1).\n2. **Diff + reuse.** Hand the stamped tree to `RetainedRender.step`, which `Reconcile.diff`-s it\n   against the retained `prev`, reuses unchanged subtrees' cached fragments and the previous\n   `Layout` bounds (incremental re-measure, 097\u002F101 \u002F R2), and re-keys per-control state to the\n   stable `RetainedId` so it survives a positional shift (091 \u002F E2).\n3. **Advance clocks + sample.** On `host.Tick delta`, advance each identity's `AnimationClock` by the\n   **injected** delta (`RetainedRender.advance`; no wall-clock), then paint composites the active\n   clock's cross-fade with `RetainedRender.sampleOnPaint` (099\u002F103 \u002F R4\u002FR6). A settled\u002Fabsent clock\n   paints byte-identically to the static render.\n4. **Route input.** Keys go focus-first (text seam → `routeFocusedKey` → `host.MapKey`); pointer\n   samples hit-test to a stable identity and dispatch the hit control's authored bindings (or\n   `host.MapPointer`).\n\n## Runnable example — fill the host, run it\n\nThe consumer surface is just the `InteractiveAppHost` record; the retained wiring is automatic.\n\n```fsharp\nopen System\nopen FS.Skia.UI.Scene\nopen FS.Skia.UI.Controls\nopen FS.Skia.UI.Controls.Elmish\nopen FS.Skia.UI.SkiaViewer\n\nlet host : InteractiveAppHost\u003CModel, Msg> =\n    { Init = fun () -> initModel, []\n      Update = fun msg model -> update msg model              \u002F\u002F pure: 'model -> 'model * ViewerEffect list\n      View = fun (size: Size) model -> view size model        \u002F\u002F size-aware: returns Control\u003C'msg>\n      Theme = Theme.light\n      MapKey = fun key isDown -> mapKey key isDown            \u002F\u002F last-resort: only keys no focused control consumed\n      MapPointer = fun interaction -> mapPointer interaction  \u002F\u002F fallback for unconsumed hits\n      Tick = fun (delta: TimeSpan) -> None                    \u002F\u002F delta drives the per-identity AnimationClock\n      Diagnostics = Viewer.defaultDiagnostics }\n\n\u002F\u002F runInteractiveApp holds the RetainedRender in interpreter-edge ref state and produces every\n\u002F\u002F frame via RetainedRender.step — the consumer record above is unchanged from 085 (096–103 added\n\u002F\u002F no field; the live behavior rides the internal seam).\nControlsElmish.runInteractiveApp { Title = \"App\"; InitialSize = { Width = 1024; Height = 768 } } host\n```\n\n```fsharp\n\u002F\u002F Maintainer view of the per-frame seam (internal symbols, reached via InternalsVisibleTo):\n\u002F\u002F 1. stamp runtime visual state pre-reconcile (096):\nlet stamped = ControlRuntime.applyRuntimeVisualState runtimeModel (host.View size model)\n\u002F\u002F 2. diff + reuse fragments\u002Fbounds, carrying StateByIdentity\u002FLayout\u002FTheme (091\u002F097\u002F101):\nlet frame   = RetainedRender.step host.Theme size prev stamped\n\u002F\u002F 3. on Tick, advance each identity's clock by the INJECTED delta (099 — no wall-clock):\nlet clock'  = RetainedRender.advance delta clock\n\u002F\u002F 4. route a key focus-first; an unconsumed key falls through to host.MapKey:\nlet retained', runtimeMsgs, productMsgs = ControlsElmish.routeFocusedKey retained focused order key shift\n\u002F\u002F 5. resolve a pointer to a stable identity (no unkeyed-sibling collision, 092):\nlet hit     = RetainedRender.retainedHitTest x y prev\n```\n\n## Key & pointer routing (the seam's two edges)\n\n- **Keys are routed focus-first** (feature 094 \u002F E4). Each native key is offered to the E1\n  `routeFocusedText` text seam (a focused TEXT control's printable keys), then to internal\n  `routeFocusedKey retained focused order key shift`, which reads the focused control's\n  `KeyboardOperation` and applies `Focus.route`: `Activate` fires the focused control's authored\n  activation bindings once; `Navigate` steps its value\u002Fselection (a slider's arrow); `Traverse`\n  moves focus via `Focus.traverse`; `Fallthrough` yields no message — and **only then** the host\n  consults `host.MapKey`. So `MapKey` is the last resort for keys no focused control and no traversal\n  consumed.\n- **Pointers resolve to a stable identity** (feature 092 \u002F FR-004). `RetainedRender.retainedHitTest`\n  (via the adapter's `resolveFocus`) returns the deepest retained node whose cached `Fragment.Box`\n  contains the point — a **per-node** identity with no unkeyed-same-kind-sibling collision (unlike\n  the `ControlId` `hitTest` path). A press sets focus to the focusable control under it (so a later\n  key reaches it); the hit control's authored `EventBindings` win, with `host.MapPointer` the\n  fallback for unconsumed interactions.\n\n## Persistent problems\n\nWhen the host loop, a clock, or a route will not behave after reasonable in-repo attempts,\n**official online docs first** (the F#\u002F.NET docs and the driven library's own documentation — Elmish\nMVU for the update\u002Feffect boundary, React reconciliation\u002Fkeys as the keyed-diff prior art), then\ncommunity sources (forums, issue trackers, changelogs). Record findings and resolving links in\n`specs\u002F\u003Cfeature>\u002Ffeedback\u002F` and, for durable lessons, in this skill's **Sources** line. Offline,\nrecord \"research blocked — \u003Cwhy>\" rather than hard-failing the phase.\n\n## Related\n\n- [[fs-skia-reconciliation]] — the keyed VDOM diff and the retained `RetainedRender` structure this\n  host drives each frame (`step`, the bounds cache, the animation clock, `sampleOnPaint`).\n- [[fs-skia-viewer-host]] — the **consumer-facing** counterpart: filling in `InteractiveAppHost`,\n  the preview-vs-tree (`Control.render` vs `Control.renderTree`) distinction, the windowed-fullscreen\n  blur caveat, and keyboard warm-up.\n- [[fs-skia-ui-widgets]] — building the `Control\u003C'msg>` tree (and its E1–E5 capabilities) this host\n  renders and routes input to.\n- [[fs-skia-elmish]] — the MVU `init`\u002F`update`\u002F`Effect` wiring the host's interpreter edge folds.\n\n## Sources \u002F links\n\n- Feature 085 (interactive host) \u002F 091–103 (live retained path): `specs\u002F085-*\u002Fplan.md`,\n  `specs\u002F104-refresh-live-path-skills\u002Fplan.md`; signatures in `src\u002FControls.Elmish\u002FControlsElmish.fsi`\n  and `src\u002FControls\u002FRetainedRender.fsi`.\n- Elmish (the MVU model the host loop follows): https:\u002F\u002Felmish.github.io\u002Felmish\u002F\n- React reconciliation & keys (keyed-VDOM-diff prior art the retained path builds on):\n  https:\u002F\u002Freact.dev\u002Flearn\u002Fpreserving-and-resetting-state\n- F#\u002F.NET docs: https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fdotnet\u002Ffsharp\u002F\n",{"name":5,"metadata":23,"description":7,"compatibility":26},{"author":24,"source":25},"fs-skia-ui","specs\u002F104-refresh-live-path-skills\u002Fplan.md","F# net10.0; FS.Skia.UI.Controls.Elmish package. Public entry `ControlsElmish.runInteractiveApp` (feature 085); the per-frame retained wiring is `module internal RetainedRender` (Controls) + internal host seams (`routeFocusedKey`, `resolveFocus`) reached via InternalsVisibleTo. Zero public-surface delta from the 096–103 roadmap — `runInteractiveApp`'s signature is unchanged.","main","f943406829a9218b2882e09eb88d4ddb539c5e72",".agents\u002Fskills\u002Ffs-skia-controls-host",0,"https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI","https:\u002F\u002Fgithub.com\u002FEHotwagner","2026-06-16 16:16:52",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add EHotwagner\u002FFS-Skia-UI --skill fs-skia-controls-host",{"tool":40,"command":41},"bunx","bunx skills add EHotwagner\u002FFS-Skia-UI --skill fs-skia-controls-host",{"tool":43,"command":44},"pnpm","pnpm dlx skills add EHotwagner\u002FFS-Skia-UI --skill fs-skia-controls-host","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Ffs-skia-controls-host\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M72SGYR4T02T1HTS175E0V86","fs-skia-ui-widgets","Generated product guidance for Skia-rendered FS.Skia.UI Controls, rich text, chart controls, graph controls, DataGrid, and custom wrappers.","https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002Ftemplate\u002Fproduct-skills\u002Ffs-skia-ui-widgets\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M72SGVZJR1B117QK7TCC6E0J","fs-skia-testing","Assert generated-product expectations and evidence in a governed FS.Skia.UI product.","https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002Ftemplate\u002Fproduct-skills\u002Ffs-skia-testing\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M72SGTC5HZYEVVVZT4X51AZ3","fs-skia-skiaviewer","Wire a generated FS.Skia.UI product to the desktop viewer host.","https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002Ftemplate\u002Fproduct-skills\u002Ffs-skia-skiaviewer\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M72SGS47RPYPC9JTC39CC6EF","fs-skia-scene","Build pure scene descriptions in a generated FS.Skia.UI product.","https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002Ftemplate\u002Fproduct-skills\u002Ffs-skia-scene\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M72SGQF4G76C4NGSF69KZRRF","fs-skia-keyboard-input","Map keyboard input to product commands in a generated FS.Skia.UI product.","https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002Ftemplate\u002Fproduct-skills\u002Ffs-skia-keyboard-input\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M72SGNJP3PMSS2VRP98G7Z42","fs-skia-elmish","Drive a generated FS.Skia.UI product through the pure Elmish adapter.","https:\u002F\u002Fgithub.com\u002FEHotwagner\u002FFS-Skia-UI\u002Fblob\u002Fmain\u002Ftemplate\u002Fproduct-skills\u002Ffs-skia-elmish\u002FSKILL.md",[],[]]