RMT Reference: Surfaces, Lanes und Lifecycle

Die normalisierten Runtime-Records werden von tools/rmt-language/vnext-surfaces.js und dem Scheduler erzeugt.

Surfaces beschreiben UI-Flächen. Lanes planen Arbeit. Lifecycle-Operationen beschreiben, welche Arbeit in einer Lane passiert.

Syntax

Operator	Form	Allowed contexts	Parameters	Function	Diagnostics	Related operators
kind	surface shell kind page	Surface-Header, Overlay, Resource	Katalogwert oder Identifier	Klassifiziert Surface, Overlay oder Resource.	Surface-Header erlaubt nur kind und component.	component
component	component x-section	Surface-Header	Custom-Element-Name oder Identifier	Bindet eine Host-Komponente.	Unerwartete Header-Clauses werden gemeldet.	surface
source	source selector app.items	Surface, Resource	Source-Art und Referenz	Bindet einen Primitive-Record als Quelle.	Fehlende Referenzen werden semantisch gemeldet.	repeat from
repeat from	repeat from selector app.items	Surface	Source-Referenz	Erzeugt wiederholte Surface-Instanzen.	Repeater brauchen stabile Keys.	key
key	key item.id	Surface	Pfad	Deklariert den stabilen Repeater-Key.	Unkeyed Repeater können blockiert werden.	repeat from
bounds	bounds x 0 y 0 width 640 height 400	Surface	Schlüssel/Wert-Paare	Setzt initiale Geometrie.	Bounds-Keys brauchen Werte.	surface
preserve on minimize	preserve on minimize	Surface	Raw-Clause	Erhält Surface-State beim Minimieren.	Nur in Surface erlaubt.	preserve
destroy releases	destroy releases resource app.stream	Surface	Resource-Referenz	Bindet Surface-Destroy an Resource-Cleanup.	Resource muss existieren.	resource, dispose
lane	lane visible weight 80 { ... }	Surface	Lane-Name, optional weight	Gruppiert geplante Arbeit.	Lanes dürfen nur Lifecycle oder stream enthalten.	weight, mount
weight	weight 80	Lane-Header	nichtnegative Ganzzahl	Priorisiert Lane-Arbeit.	Gewicht muss eine nichtnegative Ganzzahl sein.	lane
mount	mount card from endpoint app.card	Lane, Slot	Target, optionale Source, Condition, Policy	Materialisiert neue UI-Arbeit.	Operationen dürfen nicht top-level stehen.	slot, when
hydrate	hydrate card from selector app.card	Lane, Slot	Target, Source	Füllt vorhandene UI mit Daten.	Source-Art muss erlaubt sein.	hydration policy
suspend	suspend card	Lane, Slot	Target	Pausiert eine UI- oder Resource-Einheit.	Nur in Lane oder Slot erlaubt.	resume
resume	resume card	Lane, Slot	Target	Setzt pausierte Arbeit fort.	Nur in Lane oder Slot erlaubt.	suspend
invalidate	invalidate card	Lane, Slot	Target	Markiert Arbeit als neu zu berechnen.	Nur in Lane oder Slot erlaubt.	update
dispose	dispose card	Lane, Slot, Resource-Block	Target oder Cleanup-Text	Gibt Arbeit oder Resource frei.	Falscher Kontext wird gemeldet.	destroy releases
prewarm	prewarm data from worker prepare	Lane, Slot	Target, Source	Bereitet Daten oder UI vor, bevor sie sichtbar werden.	Source-Art muss statisch sein.	worker, idle
recycle	recycle row from resource pool	Lane, Slot	Target, Source	Verwendet vorhandene Instanzen wieder.	Resource muss existieren.	resource
detach	detach panel	Lane, Slot	Target	Trennt eine Surface-Einheit vom aktuellen Host-Kontext.	Nur in Lane oder Slot erlaubt.	reattach
reattach	reattach panel	Lane, Slot	Target	Bindet eine getrennte Einheit wieder ein.	Nur in Lane oder Slot erlaubt.	detach
stream	stream feed from sse app.feed	Lane, Slot	Target, Source	Beschreibt inkrementelle Rendering-Daten.	stream verlangt eine Datenquelle.	sse, sanitize
slot	slot header { hydrate title from selector app.title }	Policy-Block	Slotname	Gruppiert Operationen in einem Composition-Slot.	Slots erlauben nur Lifecycle oder stream.	mount, hydrate
resumability	resumability mode server_prerender_resume	Policy-Block	mode, snapshot, event replay oder integrity	Deklariert vollständige SSR-Resumability als Resume-Übergabe.	Clauses müssen statisch sein und eine bekannte Resumability-Achse nutzen.	hydration mode, resume

Allowed contexts

lane steht direkt in surface. Lifecycle-Operationen und stream stehen in lane oder slot. slot, on, trust, hydration, resumability, isolation und sanitize stehen in Policy-Blöcken von Lifecycle-Operationen.

bounds bleibt standardmäßig pixelgenau; responsive Bounds sind opt-in und akzeptieren gequotete CSS-native Größen, zum Beispiel bounds mode responsive scope viewport x "1rem" y "1rem" width "clamp(20rem, 70vi, 52rem)" height "min(80dvh, 42rem)" minWidth "18rem" maxHeight "48rem".

Parameters

Targets sind Identifier. Sources folgen from <kind> <target>. Conditions folgen when. Policy-Blöcke verwenden geschweifte Klammern.

Description

Lifecycle-Syntax trennt sichtbare Arbeit, user-blocking Interaktion, Hintergrundarbeit und Diagnostics. Der Host kann diese Records auf Scheduler-Lanes abbilden, ohne freie Funktionen aus der RMT-Quelle auszuführen.

Examples

template reference.lifecycle {
  state app.ready type boolean initial true
  state app.status type object preserve {
    initial {
      text "Ready"
    }
  }
  selector app.header from state app.status {
    output HeaderView
  }
  selector app.cardView from state app.status {
    output CardView
  }
  resource app.stream kind stream owner surface.shell
  resource app.pool kind object-url owner surface.shell
  portal app.root root "#app" layer surface

  surface shell kind page component x-section {
    portal app.root
    bounds x 0 y 0 width 640 height 400
    preserve on minimize
    destroy releases resource app.stream
    lane visible weight 90 {
      mount shell.card from endpoint app.card when app.ready == true {
        slot header {
          hydrate header.view from selector app.header
        }
        on click ".save" -> action app.save {
          payload id from target.dataset.id
          preventDefault true
        }
      }
      hydrate shell.card from selector app.cardView {
        hydration mode server_prerender_resume
        resumability mode server_prerender_resume
        resumability snapshot surface_state
        resumability event replay intent_queue
        resumability integrity signed_manifest
      }
      suspend shell.card
      resume shell.card {
        resumability mode server_prerender_resume
        resumability snapshot surface_state
        resumability event replay intent_queue
        resumability integrity signed_manifest
      }
      invalidate shell.card
      dispose shell.card
      prewarm shell.data from worker app.prepare
      recycle shell.row from resource app.pool
      detach shell.panel
      reattach shell.panel
      stream shell.feed from sse app.feed
    }
  }

  action app.save {
    input id string
    reduce state.app.status.text = "Saved"
    emit app.saved with id input.id
  }
}

Diagnostics

Lifecycle- und Stream-Statements außerhalb von Lane oder Slot erzeugen Kontextdiagnosen. Fehlende Selector-, Resource- oder Action-Referenzen werden semantisch gemeldet.

Related operators

surface, portal, source, when, slot, on, resource, trust boundary.

Weiterführend

Der RMT-Referenzindex verbindet Surfaces und Lanes mit Scheduling- und Lifecycle-Syntax. Verwandter Artikel