jsgui3-ssr-activation-data-bridge

Diagnose jsgui3 server-rendered markup hydration and client-side control activation issues.

1|Updated Sep 12, 2025
One-click install
npx skills add https://github.com/metabench/copilot-dl-news --skill jsgui3-ssr-activation-data-bridge-metabench
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jsgui3-ssr-activation-data-bridge
Source: https://github.com/metabench/copilot-dl-news/tree/main/docs/agi/skills/jsgui3-ssr-activation-data-bridge
Command: npx skills add https://github.com/metabench/copilot-dl-news --skill jsgui3-ssr-activation-data-bridge-metabench

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Server-rendered jsgui3 pages sometimes fail to come alive in the browser: clicks do nothing, persisted fields never hydrate, and the console fills with cryptic warnings like "Missing context.map_Controls" or "&&& no corresponding control". This Skill explains the real runtime path from SSR HTML to client activation so you can pinpoint and patch the exact failure point. ## Core Features & Use Cases - Activation Path Tracing: Walks through the full client boot sequence (Client_Page_Context creation, pre_activate reconstruction, depth-first activate) so you know exactly where hydration breaks. - Data Bridge Decoding: Explains how data-jsgui-fields hydrates _persisted_fields and how data-jsgui-ctrl-fields wires named child controls like this.btn or this.status. - Warning Triage & Patching: Interprets common console warnings and offers safe patch strategies, from silencing known-noise logs to registering missing control types and handling whitespace text nodes. - Use Case: Your SSR docs viewer renders fine but the collapsible nav and sortable column headers are inert. Use this Skill to confirm the bridge attributes exist, discover the ctrl_fields binding failed, and apply the validated manual DOM query pattern in activate(). ## Quick Start Ask the AI to debug why my jsgui3 server-rendered page renders correctly but its buttons do not respond to clicks after client activation.

Frequently Asked Questions about jsgui3-ssr-activation-data-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do jsgui3 SSR pages render but clicks don't work?▼

SSR click failures usually mean client activation never completed. Check that the HTML contains data-jsgui-id and data-jsgui-ctrl-fields attributes, then verify pre_activate reconstructed the controls and activate() bound the event handlers depth-first.

How do I hydrate persisted fields in jsgui3 controls?▼

jsgui3-html reads the data-jsgui-fields DOM attribute during control construction and stores it as _persisted_fields. Your control should consume _persisted_fields inside its activate() method to restore server-rendered state.

What does 'Missing context.map_Controls for type' mean in jsgui3?▼

This warning means the DOM declared a control type that has no constructor registered in context.map_Controls, so the client falls back to a generic Control. It is often harmless log noise for exempt tags like html, head, and body, but real types need registration near client startup.

How do I fix '&&& no corresponding control' warnings in jsgui3?▼

This warning appears when pre-activation finds DOM text nodes, usually whitespace or newlines, with no matching entry in the control content array. It is typically benign, but you can patch pre_activate_content_controls to skip empty text nodes during alignment.

When should I use manual DOM queries instead of ctrl_fields in jsgui3?▼

Use explicit el.querySelector calls inside activate() when ctrl_fields binding fails due to patched bundles or server-added elements missing from the content array. This fallback pattern is validated in ResizableSplitLayoutControl and ColumnHeaderControl implementations.