Skip to content

Readme.md

Latest commit

 

History

History
84 lines (62 loc) · 2.31 KB

Readme.md

File metadata and controls

84 lines (62 loc) · 2.31 KB

FROG logo

🐸 Reference UI Host

Host-side UI binding layer for the non-normative FROG reference implementation
FROG — Free Open Graphical Language

Overview

This directory contains the host-side UI binding layer used by the first reference runtime family. Its role is to connect runtime execution with front-panel-oriented interaction when the accepted backend contract declares UI participation support.

Scope of the First Slice

The first slice should remain intentionally narrow. It should support:

  • widget_value participation,
  • widget_reference participation,
  • frog.ui.property_read,
  • frog.ui.property_write,
  • frog.ui.method_invoke.

It should not silently expand that into a first-class standardized event execution model.

What this Directory Owns

  • runtime-to-UI binding mechanics for the reference family,
  • widget handle resolution for the reference runtime,
  • host-side property and method dispatch for standardized UI primitives,
  • family-specific refresh and commit mechanics.

What this Directory Does Not Own

  • the normative widget model,
  • the normative distinction between widget_value and widget_reference,
  • a universal UI runtime architecture,
  • a standardized first-class event model for all backends.

Design Rules

  • Preserve the distinction between natural value participation and object-style interaction.
  • Preserve the distinction between widget-reference participation and standardized UI-object primitive operations.
  • Keep host-side UI mechanics private to the reference family.
  • Do not let toolkit-specific behavior redefine FROG meaning.

Summary

The UI host is the bridge between the first reference runtime and host-side widget behavior. It is intentionally narrow, family-specific, and downstream from the published UI and backend-contract boundaries.