Skip to content

Screens capability matrix

This page traces each language-level screens release criterion to the Screenplay syntax that expresses it, how the compiler treats it, the diagnostics that guard it, and anything the language cannot yet express. It covers the authoring language only. Rendering and runtime proof live in the screens release acceptance matrix.

“Executable model” means the backend executable semantic model (ESM). UI constructs are explicitly deferred from it with PLAY0269; they are authored, validated, printed and exported, and Stage plans them from the syntax tree.

Criterion Syntax Semantics Diagnostics Not expressible
Screen identity (536.2) screen <Name> in a slice; description Authoring; PLAY0269 in the ESM PLAY0103 malformed directive None
Package components and exact stable ids (536.2) component <Package.Component> <name>, id "<stable-id>" Authoring; the stable id is never normalized PLAY0103, PLAY0632 package not in a ui profile None
Typed bindings (536.2) from data, from query, from component, from literal, mode, null, expected Typed UiBindingSyntax; invalid text kept as rawText PLAY0103 None
Typed literals (536.2) property <path> = <string, number, bool or null>; indented structured values for objects and lists Typed ExpressionSyntax PLAY0103, PLAY0833 inline JSON None
Exposed values (536.2) exposes <name> from <binding> on components; exposes <name> <Type> on templates Authoring PLAY0103, PLAY0026 None
Toolbars and presentation (536.2) toolbar, item, presentation, icon Authoring PLAY0103 None
Criterion Syntax Semantics Diagnostics Not expressible
Command forms (536.2) form <Name> for <Command>, field, populate, on submit Authoring PLAY0208–PLAY0216 None
Generation mode and geometry, Scene 4.12 (536.2) generation auto|manual, layout with column, place, columnGap, rowGap CommandFormLayoutSyntax maps 1:1 to Scene CommandFormLayout PLAY0210 malformed generation or layout lines None
Criterion Syntax Semantics Diagnostics Not expressible
Template categories and assignment (536.2, 536.3) layout, screen template, dialog template, category, type, template <Name> at module, feature or slice Hierarchical; the nearest assignment wins PLAY0026, PLAY0631 scope mismatch, PLAY0720 missing category None
Blueprint template references and slice kinds (Scene#98) template blueprint <Blueprint> <Name> [version "<range>"]; scopes slice statechange|stateview Scene TemplateReference (source, id, blueprint, version) and Metadata.SliceKinds; applicability by ApplicableTemplates PLAY0721 invalid version range, PLAY0722 blueprint not in a profile, PLAY0631 slice kind mismatch None
Template picker metadata display, description, scopes Scene DisplayName, Description, Metadata.Scopes PLAY0026, PLAY0631 None
Template content content <slot> with screen directives Scene template Content PLAY0629 unknown slot, PLAY0656 nesting cycle None
Arrangements arrangement flow|freeform, row, column, grid columns rows, grow, span, when, variant, place Scene FlowArrangement, FreeformArrangement PLAY0235, PLAY0236 None
Exposures exposure for <Owner>, property <component>.<path> with label, operations, fields, reexposes Scene ExposureDeclaration PLAY0621–PLAY0624 None
Instance values instance <X> with set and items Scene InstanceContribution PLAY0625–PLAY0628 None
Screen contributions contribute to <Point> [order <n>] inside a screen Scene Screen.Contributions PLAY0655 unknown point None
Recursive slots (536.3) slot <name> on layouts, templates and components (Screenplay 5 outlet <name>: PLAY0890, PLAY0893) Authoring PLAY0630 unknown slot None
Criterion Syntax Semantics Diagnostics Not expressible
Navigation targets and URL overrides (536.3) navigate to <Screen> [by <param>], route, slot, parameter Scene DestinationReference PLAY0107, PLAY0197 unknown screen, PLAY0630 None
Navigation items contribute to <Point> with navigate, label, order, id, icon, presentation, group, destination slot|dialog|external Scene NavigationItem and DestinationKind PLAY0217–PLAY0223, PLAY0654 unknown destination, PLAY0903 unknown outlet None
Application navigation outlets (spec NAV1-NAV12) outlet <name> of navigation with logo and default items on a layout; outlet <name> inherits|extends|overrides with item <id> title target slot, hide and before|after on a module, feature or screen Scene NavigationModel: ApplicationNavigation, ModuleNavigation, NavigationRegion and NavItem; the module mode is Scene’s NavigationRegionMode PLAY0741-PLAY0752, PLAY0894-PLAY0905 None. The TypeScript compiler reads a module’s, feature’s or screen’s outlets and reports their form; the reference checks are C#-only
Toolbar buttons invoking State Change slices (spec TB1-TB6) button <id> title "…" [slice <Slice>] [emphasis primary|secondary|quiet] [icon <name>] in a screen toolbar Scene ToolbarButton (Slice, Emphasis, Icon) PLAY0760 syntax checks in C# and TypeScript; PLAY0761-PLAY0765 slice-reference and duplicate-id checks in C# None
Dialog placement (536.3) open dialog <DialogTemplate>, destination dialog <DialogTemplate> Authoring PLAY0654 None
Criterion Syntax Semantics Diagnostics Not expressible
Packages and icons (536.2) packages and icons in a ui profile Authoring PLAY0632 component from an undeclared package None
Design-time output (536.6) A design-time action’s result is ordinary syntax: instance values, form fields and layout Package callbacks stay in the package; only their output is source The diagnostics of the constructs it produces Package code and callbacks, by design
Criterion Proof
Parser-printer-parser preservation (536.4) when_printing_screen_composition, when_printing_screen_release_ui_contract
References and cycles (536.4) Corpus rejection vectors for template nesting cycles, re-exposure cycles, out-of-scope screen references, missing slots and destinations
.NET and TypeScript parity (536.5) Shared transport schema, golden syntax vectors and Conformance/diagnostics.json
Language service (536.5) when_surfacing_screen_composition_diagnostics (validation, keywords, highlighting, native diagnostic markers)
Authoring separate from executable readiness (536.5) UI constructs are authored and validated; the ESM reports them as PLAY0269 deferred
MCP remove and move (537.1) when_moving_and_removing_screen_nodes
MCP missing package (537.3) when_moving_and_removing_screen_nodes: removing a package a component still uses is refused with PLAY0632
MCP navigation outlets (765) when_authoring_the_screen_shell: add, switch mode with copy, extend an inheriting region, add and remove sub-items; a copy that targets another module is refused with PLAY0750, a missing target with PLAY0748; stale revision refused
MCP toolbar buttons (765) when_authoring_the_screen_shell: add a button, point it at a State Change slice, remove it; a State View slice is refused with PLAY0762; stale revision refused
MCP template references (765) when_authoring_the_screen_shell: change the version range of a module and a screen reference; an unreadable range is PLAY0721, an unlisted blueprint PLAY0722; stale revision refused
MCP sample data (762, 765) when_authoring_sample_data: replace a row value, change the active pack the ui profile selects, remove a pack; an undeclared pack is PLAY0714
Typed edit of a member that is empty and omitted from the node JSON (765) when_adding_to_a_member_that_is_omitted_while_empty: the first region, button or sub-item can be added
Canonical shell vector (765) screen-shell-navigation-positive, seven rejection vectors and a Desktop Stage plan in ScreenCompositionCorpus.V1, held by when_compiling_the_screen_shell_vectors and when_compiling_the_v1_screen_composition_vectors; the TypeScript compiler accepts the same document in Conformance/diagnostics.json

TypeScript parsing and preservation do not cover every construct above: application navigation blocks are skipped, not preserved. Toolbar buttons are parsed and preserved, with syntax checks (PLAY0760); slice-reference and duplicate-id checks (PLAY0761–PLAY0765) run in C#. The other reference checks (owners, instances, cycles, slots, destinations, scopes, outlets, packages) also run in the C# compiler; the language service shows the native checks when a Monaco host supplies the native compiler’s diagnostics.