UJG / Editor's Draft /
GitHub
Table of Contents
  • 1Overview
  • 2Terminology
  • 3TransitionMaterialization
  • 4Materialization steps
  • 5FocusMoveKind and MoveKind
  • 6AdjacentTransition direction
  • 7Performing a Materialization
  • 8Normative Artifacts
    • 8.1Ontology
    • 8.2JSON-LD Context
    • 8.3Validation
  • 9Examples
    • 9.1Mail Tabs Example
    • 9.2Selection Follows Focus Example
    • 9.3Carousel Example
W3C Community Group Draft Report

Operability

draft

Status of this Document

This report was published by the User Journey Graph Community Group . It is not a W3C Standard nor is it on the W3C Standards Track. Please note that under the W3C Community Contributor License Agreement (CLA) there is a limited opt-out and other conditions apply. Learn more about W3C Community and Business Groups .

Last Update
2026-11-21
Editors
  • Seva Dolgopolov
Group
User Journey Graph Community Group
Repository
View Source
License
W3C-Software-and-Document

1. Overview

This third-level optional module describes how a user performs a Graph transition through an input modality.

Take two States with a Transition between them: "Home selected" and "Drafts selected", connected by "Select Drafts". With a pointer, the user clicks the Drafts tab. With a keyboard, the user moves focus over a few buttons in between, reaches the Drafts tab, and activates it. With a shortcut, the user presses the keys that the Drafts tab offers as its shortcut. All three perform the same Transition. Each one is a TransitionMaterialization. Each move past a button on the way is one of its steps, and so is the final activation.

Operability depends on [UJG Graph] for the transitions it describes, on [UJG Surface] for the Surfaces of the Commands that steps act on, and on [UJG Observability] for input modalities and for the locators that name the objects a step reaches. Observability is a second-level module, so Operability is a third-level module. Graph does not depend on Operability: a transition without a materialization is complete.

Surface gives Graph nodes a visible materialization. A TransitionMaterialization describes how a transition is performed. Operability references Graph transitions directly because no lower-level module covers them: a Surface never references a transition, and Observability attaches only to Surfaces.

Operability names kinds of moves, such as "next item", not keys. A Platform adapter performs each step with the gestures of its platform and input modality, for example ArrowRight in a web tab list or the right button of a TV remote [WAI-ARIA-APG].

This version covers moving focus or the pointer between objects, moving the view by a page, activating objects, and shortcuts. Entering or selecting text, or changing a value, as part of a transition is outside this version.

2. Terminology

  • TransitionMaterialization: One way to perform one Graph transition through one input modality.

  • Materialization step: One action of the user within a TransitionMaterialization: a MoveStep, an ActivationStep, or a ShortcutStep.

  • MoveStep: A materialization step in which the user moves to another object, such as the next button, or moves the view by a page.

  • ActivationStep: A materialization step in which the user performs the default action of the object they are at.

  • ShortcutStep: A materialization step in which the user performs the shortcut that an object exposes.

  • FocusMoveKind: A platform-neutral kind of focus move, such as moving to the next item of a tab list.

  • MoveKind: A platform-neutral kind of move that does not move focus, such as moving the pointer onto an object or moving the view by a page.

  • MaterializationDirection: Which of the two movements of an AdjacentTransition a TransitionMaterialization performs.

  • Platform adapter: The part of a consumer, such as a Synthetic Runner, that turns materialization steps into the gestures of one platform and input modality, for example key presses in a browser.

  • Performable materialization: A TransitionMaterialization whose every step can be performed without guessing a detail it leaves out.

3. TransitionMaterialization

A TransitionMaterialization references the transition it performs with materializationTransitionRef, the input modality it uses with materializationModalityRef, and its steps with materializationStepRefs. The transition can be a Transition, an AdjacentTransition, an OutgoingTransition, or an InvokingTransition. A transition can have several materializations, for example one by keyboard, one by pointer, and one by shortcut.

Where the user starts matters for the steps. materializationStartLocatorRef can name the object the user is at before the first step, such as the Inbox tab right after Inbox was selected. When it is omitted, the start is not described.

A Transition starts at its from vertex, so its steps happen there. An entry transition has no from: every State that lists it offers it, and each of those States can need different steps to reach it. materializationSourceStateRef names the State in which the steps are performed. Without it, the steps apply at every State that lists the transition. In the same way, a transition that leaves a CompositeState is performed in one of the States nested in it, and materializationSourceStateRef can name that State.

Some transitions are not performed by a user action. A Transition with fromExitRef is taken when a child Journey of its CompositeState reaches that JourneyExit. The user's steps lead to the exit, so they belong to the child Journey's Transition into the exit, and that Transition is the one to materialize.

  1. A TransitionMaterialization describes one way to take its transition through its input modality: the user performs its steps one after another, and the last step takes the transition.

  2. Several TransitionMaterializations of the same transition are alternatives. Any one of them takes the transition.

  3. A TransitionMaterialization does not change its transition. Graph meaning never depends on Operability, and a transition without a materialization is complete.

  4. Materialization steps stay below Graph. The steps before the last one take no Graph edge.

  5. When the user passes through another State on the way, Producers MUST model each part as its own transition with its own materialization, not as steps of one materialization. In a tab list whose selection follows focus, for example, moving from the Home tab to the Drafts tab passes through the Inbox tab and so takes two transitions.

  6. One materialization of a member transition serves every member of its StateCollection. Its locators name the kind of object, and the concrete object is known only when the step happens.

  7. When the materialized transition has a commandRef, the object that its last step reaches or acts on SHOULD be one that an ObservationBinding recognizes for a Surface of that Command. A transition without a Command can still be materialized.

How a materialization is performed and checked is described in the Performing a Materialization section.

classDiagram
  class Transition
  class AdjacentTransition
  class OutgoingTransition
  class InvokingTransition
  class InputModality
  class AccessibleLocator
  class CustomLocator
  class State
  class MaterializationDirection
  class MoveStep
  class ActivationStep
  class ShortcutStep
  class TransitionMaterialization {
    id
    materializationTransitionRef
    materializationModalityRef
    materializationStepRefs
    materializationStartLocatorRef
    materializationSourceStateRef
    materializationDirectionRef
  }
  TransitionMaterialization --> Transition : materializationTransitionRef
  TransitionMaterialization --> AdjacentTransition : materializationTransitionRef
  TransitionMaterialization --> OutgoingTransition : materializationTransitionRef
  TransitionMaterialization --> InvokingTransition : materializationTransitionRef
  TransitionMaterialization --> InputModality : materializationModalityRef
  TransitionMaterialization --> "0..*" MoveStep : materializationStepRefs
  TransitionMaterialization --> "0..*" ActivationStep : materializationStepRefs
  TransitionMaterialization --> "0..*" ShortcutStep : materializationStepRefs
  TransitionMaterialization --> AccessibleLocator : materializationStartLocatorRef
  TransitionMaterialization --> CustomLocator : materializationStartLocatorRef
  TransitionMaterialization --> State : materializationSourceStateRef
  TransitionMaterialization --> MaterializationDirection : materializationDirectionRef

Example JSON node:

json
{
  "@type": "TransitionMaterialization",
  "@id": "urn:ujg:materialization:select-drafts:pointer",
  "materializationTransitionRef": "urn:ujg:transition:select-drafts",
  "materializationModalityRef": "observability:pointer",
  "materializationStepRefs": [
    "urn:ujg:step:select-drafts:pointer:1",
    "urn:ujg:step:select-drafts:pointer:2"
  ]
}
{
  "@type": "TransitionMaterialization",
  "@id": "urn:ujg:materialization:select-drafts:pointer",
  "materializationTransitionRef": "urn:ujg:transition:select-drafts",
  "materializationModalityRef": "observability:pointer",
  "materializationStepRefs": [
    "urn:ujg:step:select-drafts:pointer:1",
    "urn:ujg:step:select-drafts:pointer:2"
  ]
}

4. Materialization steps

A materialization has three kinds of steps. A MoveStep covers each button or other object the user passes or points at on the way, and each page the view moves by. An ActivationStep activates the object the user is at. A ShortcutStep performs the shortcut that an object exposes.

Each step can name the object it reaches or acts on with stepLocatorRef. This detail is optional: a step without a locator still counts as one step of the path. The number of steps describes how much the user does to take the transition through that modality.

Each step names the step it follows with stepPreviousRef, and the first step follows none. This is how the steps are ordered; the order of the materializationStepRefs values means nothing.

  1. Each step follows the step it names in stepPreviousRef. The step that follows no step comes first, and the materialized transition happens when the last step is performed.

  2. The order of materializationStepRefs values MUST NOT define step order.

  3. A MoveStep moves the user to another object, or moves the view by a page. It is the last step only when the move itself takes the transition, as in a tab list whose selection follows focus.

  4. An ActivationStep performs the default action of the object the user is at: the focused object for a keyboard, or the object pointed at for a pointer.

  5. Every activation gesture of the platform performs an ActivationStep, such as Enter or Space on a web button, so the step does not say which one the user uses. A gesture that does something else, such as Enter submitting the form around a focused checkbox, is not an activation of that object. It is a ShortcutStep on the object it acts on, such as the form's submit button.

  6. A ShortcutStep performs the shortcut that an object exposes. It acts on that object without the user reaching it first.

  7. When a step names an object with stepLocatorRef, the object it reaches or acts on matches that locator.

  8. A MoveStep reaches what its kind designates: for a FocusMoveKind, an object such as the next item in the order the platform presents; for operability:pointAt, the object its locator names; for a page move, the page that comes into view. Except with operability:pointAt, the locator describes what the step reaches; it does not choose it.

  9. Operability defines no keys, buttons, or gestures. A Platform adapter performs each step with the gestures that its platform and input modality use for it.

  10. The gesture of a ShortcutStep is the shortcut that the accessibility API exposes for the object its stepLocatorRef names, such as aria-keyshortcuts on the web [WAI-ARIA-1.2]. When the shortcut is not exposed there, Producers MAY describe it as a private adapter hint in Core extensions.

classDiagram
  class FocusMoveKind
  class MoveKind
  class AccessibleLocator
  class CustomLocator
  class MoveStep {
    id
    stepMoveKindRef
    stepLocatorRef
    stepPreviousRef
  }
  class ActivationStep {
    id
    stepLocatorRef
    stepPreviousRef
  }
  class ShortcutStep {
    id
    stepLocatorRef
    stepPreviousRef
  }
  MoveStep --> FocusMoveKind : stepMoveKindRef
  MoveStep --> MoveKind : stepMoveKindRef
  MoveStep --> AccessibleLocator : stepLocatorRef
  ActivationStep --> AccessibleLocator : stepLocatorRef
  ShortcutStep --> AccessibleLocator : stepLocatorRef
  MoveStep --> CustomLocator : stepLocatorRef
  ActivationStep --> CustomLocator : stepLocatorRef
  ShortcutStep --> CustomLocator : stepLocatorRef

Any step can follow any step:

classDiagram
  class MoveStep
  class ActivationStep
  class ShortcutStep
  MoveStep --> MoveStep : stepPreviousRef
  MoveStep --> ActivationStep : stepPreviousRef
  MoveStep --> ShortcutStep : stepPreviousRef
  ActivationStep --> MoveStep : stepPreviousRef
  ActivationStep --> ActivationStep : stepPreviousRef
  ActivationStep --> ShortcutStep : stepPreviousRef
  ShortcutStep --> MoveStep : stepPreviousRef
  ShortcutStep --> ActivationStep : stepPreviousRef
  ShortcutStep --> ShortcutStep : stepPreviousRef

Example JSON nodes:

json
[
  {
    "@type": "MoveStep",
    "@id": "urn:ujg:step:select-drafts:keyboard:4",
    "stepPreviousRef": "urn:ujg:step:select-drafts:keyboard:3",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:ujg:locator:drafts-tab"
  },
  {
    "@type": "ActivationStep",
    "@id": "urn:ujg:step:select-drafts:keyboard:5",
    "stepPreviousRef": "urn:ujg:step:select-drafts:keyboard:4"
  }
]
[
  {
    "@type": "MoveStep",
    "@id": "urn:ujg:step:select-drafts:keyboard:4",
    "stepPreviousRef": "urn:ujg:step:select-drafts:keyboard:3",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:ujg:locator:drafts-tab"
  },
  {
    "@type": "ActivationStep",
    "@id": "urn:ujg:step:select-drafts:keyboard:5",
    "stepPreviousRef": "urn:ujg:step:select-drafts:keyboard:4"
  }
]

5. FocusMoveKind and MoveKind

A MoveStep names the kind of move it performs, without naming a key or gesture. There are two kinds of moves. A FocusMoveKind moves focus, as a keyboard does. A MoveKind moves something other than focus: the pointer, or the view.

This module defines six standard focus moves in two groups. The first group moves between the stops of sequential focus navigation, which a desktop keyboard performs with Tab and Shift+Tab:

  • operability:nextStop

  • operability:previousStop

The second group moves among the items of a composite widget, such as a tab list, menu, or grid, which a desktop keyboard performs with the arrow keys, Home, and End [WAI-ARIA-APG]:

  • operability:nextItem

  • operability:previousItem

  • operability:firstItem

  • operability:lastItem

It also defines three standard moves that do not move focus:

  • operability:pointAt moves the pointer onto the object the step's locator names, for example to open a submenu by hovering.

  • operability:nextPage and operability:previousPage move the view by one page, for example with PageDown, a mouse wheel, or a swipe in a carousel. They are a common way to cross an AdjacentTransition, such as between the sections of a scrolling view.

The keys and gestures named here only illustrate what an adapter does; they are not part of the vocabulary. The standard kinds are declared by the normative Operability ontology, so Producers can reference them without serializing them.

  1. A FocusMoveKind names a focus move, and a MoveKind names a move that does not move focus. Neither names a key or gesture.

  2. "Next", "previous", "first", and "last" follow the order in which the platform presents the stops, items, or pages when the step happens. Operability declares no order of its own.

  3. A pointer moves directly to an object, so a pointer materialization moves with operability:pointAt rather than with focus moves. Through a pointer, a click is a MoveStep with operability:pointAt followed by an ActivationStep.

  4. A MoveStep without a kind leaves the move undescribed. It documents the step, but a materialization that contains it is not performable.

  5. Producers MAY define other FocusMoveKinds and MoveKinds.

classDiagram
  class FocusMoveKind {
    id
  }
  class MoveKind {
    id
  }

6. AdjacentTransition direction

One AdjacentTransition describes movement in both directions across a border. A materialization performs one of them, and materializationDirectionRef says which. An AdjacentTransition has exactly two movements, so there are exactly two MaterializationDirections.

  1. operability:forward moves from the AdjacentTransition's from vertex to its to vertex. For a member AdjacentTransition, it moves to the neighboring member after the border.

  2. operability:backward moves the other way.

  3. Each direction can have its own materializations, which are alternatives for that direction.

classDiagram
  class MaterializationDirection {
    id
  }

7. Performing a Materialization

A Synthetic Runner can perform a materialization to check that a transition works through an input modality. It performs each step with its Platform adapter and checks along the way that the user is where the steps say. This section says what such a runner must do. Which materializations a runner performs, and how it reports results, is up to the runner; it can name a materialization by its IRI.

A materialization can leave details out and still describe a way of acting, which is enough to document it. To perform it, a runner needs every step to be determined. A materialization is performable when:

  • every MoveStep names its kind, a FocusMoveKind or a MoveKind. A locator alone would leave the runner searching for the object, which is guessing;

  • every MoveStep with operability:pointAt also names its object with stepLocatorRef, because the pointer moves straight to that object;

  • every ShortcutStep names an object that exposes its shortcut through the accessibility API, or carries a private adapter hint in Core extensions.

An ActivationStep acts on the object the user is at, so it needs nothing more. Without materializationStartLocatorRef, the steps start wherever the user is when the runner begins them.

  1. Before the first step, a Synthetic Runner that performs a materialization MUST check that the user is at the object materializationStartLocatorRef names, when it names one.

  2. Before a MoveStep with operability:pointAt, the runner MUST check that the step's locator matches exactly one object. When it matches several, the runner MUST NOT choose one, and the materialization cannot be performed there.

  3. After each MoveStep, the runner MUST check that the move happened: focus or the pointer is at a different object, or the view shows a different page. When the step names an object, the runner MUST also check that what the step reached matches the step's locator. With a keyboard, the user is at the object that has focus.

  4. Before each ActivationStep that names an object, the runner MUST check that the user is at an object that matches the step's locator.

  5. When a check fails, the materialization has failed, even if the transition happens afterwards.

  6. The runner MUST NOT place focus on an object programmatically. The steps describe what the user does, and placing focus for them would hide a defect that the steps are meant to reveal.

  7. The runner MUST NOT fill in a detail that a step leaves out. It does not perform a materialization that is not performable.

  8. After the last step, the runner MUST check that the materialized transition was taken: that the user reached its destination. How the runner recognizes the destination is up to the runner, for example through an ObservationBinding for a Surface of the destination State.

  9. Every activation gesture of the platform performs an ActivationStep, so choosing one is not filling in a detail. Performing the step with one gesture shows nothing about the others; to check several, the runner performs the step once with each.

  10. A materialization works when every check passes, including the check that the transition was taken. Each materialization is its own claim: one that works shows nothing about the others, even those through the same modality.

A materialization also shows whether an Observability requirement is met. Take an ObservationBinding that observes a Surface whose graphNodeRef is a Command. When the binding's ObservationEvent requires an InputModalityProfile that lists exactly one modality, a runner can check the requirement by performing one materialization through that modality of a transition whose commandRef is that Command. One materialization that works is enough for that requirement; checking that every materialization of the transition works means performing each of them. Each required profile is checked on its own, as Observability evaluates profiles independently. Profiles that list several modalities are outside this version.

8. Normative Artifacts

This module is published through the following artifacts:

  • operability.ttl: ontology, published at https://ujg.specs.openuji.org/ed/ns/operability

  • operability.context.jsonld: JSON-LD term mappings, published at https://ujg.specs.openuji.org/ed/ns/operability.context.jsonld

  • operability.shape.ttl: SHACL validation rules, published at https://ujg.specs.openuji.org/ed/ns/operability.shape

Examples in this page compose the shared baseline context https://ujg.specs.openuji.org/ed/ns/context.jsonld with the Surface, Localization, Observability, and Operability contexts.

8.1. Ontology

The normative Operability ontology is defined below and is published at https://ujg.specs.openuji.org/ed/ns/operability.

turtle
@prefix ujg: <https://ujg.specs.openuji.org/ed/ns/core#> .
@prefix ujggraph: <https://ujg.specs.openuji.org/ed/ns/graph#> .
@prefix ujgobservability: <https://ujg.specs.openuji.org/ed/ns/observability#> .
@prefix ujgoperability: <https://ujg.specs.openuji.org/ed/ns/operability#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix dct: <http://purl.org/dc/terms/> .

<https://ujg.specs.openuji.org/ed/ns/operability#> a owl:Ontology ;
  rdfs:label "UJG Operability Editor's Draft Vocabulary"@en ;
  dct:description "UJG Operability ontology declaration" .

### Classes

ujgoperability:TransitionMaterialization a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  rdfs:label "Transition Materialization" ;
  rdfs:comment "One way to perform one Graph transition through one input modality, described as materialization steps. Several materializations of the same transition are alternatives. A TransitionMaterialization does not change the transition." .

ujgoperability:MoveStep a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:ActivationStep, ujgoperability:ShortcutStep ;
  rdfs:label "Move Step" ;
  rdfs:comment "A materialization step in which the user moves to another object, such as the next button. Only the last step of a materialization takes the materialized transition." .

ujgoperability:ActivationStep a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:MoveStep, ujgoperability:ShortcutStep ;
  rdfs:label "Activation Step" ;
  rdfs:comment "A materialization step in which the user performs the default action of the object they are at: the focused object, or the object pointed at. Any of the platform's activation gestures performs it." .

ujgoperability:ShortcutStep a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:MoveStep, ujgoperability:ActivationStep ;
  rdfs:label "Shortcut Step" ;
  rdfs:comment "A materialization step in which the user performs the shortcut that an object exposes. It acts on that object without the user reaching it first." .

ujgoperability:FocusMoveKind a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:MoveKind ;
  rdfs:label "Focus Move Kind" ;
  rdfs:comment "A platform-neutral kind of focus move, used through input modalities that move focus, such as a keyboard. A platform adapter performs it with the gestures of its platform and input modality." .

ujgoperability:MoveKind a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:FocusMoveKind ;
  rdfs:label "Move Kind" ;
  rdfs:comment "A platform-neutral kind of move that does not move focus, such as moving the pointer onto an object or moving the view by a page. A platform adapter performs it with the gestures of its platform and input modality." .

ujgoperability:MaterializationDirection a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:equivalentClass [
    a owl:Class ;
    owl:oneOf ( ujgoperability:forward ujgoperability:backward )
  ] ;
  rdfs:label "Materialization Direction" ;
  rdfs:comment "Which of the two movements of an AdjacentTransition a TransitionMaterialization performs. An AdjacentTransition has exactly two movements, so forward and backward are the only directions." .

### Standard individuals

ujgoperability:nextStop a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Next stop"@en ;
  rdfs:comment "Moves focus to the next stop of sequential focus navigation."@en .

ujgoperability:previousStop a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Previous stop"@en ;
  rdfs:comment "Moves focus to the previous stop of sequential focus navigation."@en .

ujgoperability:nextItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Next item"@en ;
  rdfs:comment "Moves focus to the next item inside a composite widget, such as the next tab of a tab list."@en .

ujgoperability:previousItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Previous item"@en ;
  rdfs:comment "Moves focus to the previous item inside a composite widget."@en .

ujgoperability:firstItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "First item"@en ;
  rdfs:comment "Moves focus to the first item inside a composite widget."@en .

ujgoperability:lastItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Last item"@en ;
  rdfs:comment "Moves focus to the last item inside a composite widget."@en .

ujgoperability:pointAt a owl:NamedIndividual, ujgoperability:MoveKind ;
  rdfs:label "Point at"@en ;
  rdfs:comment "Moves the pointer onto the object that the step's locator names, such as hovering over a menu item to open its submenu."@en .

ujgoperability:nextPage a owl:NamedIndividual, ujgoperability:MoveKind ;
  rdfs:label "Next page"@en ;
  rdfs:comment "Moves the view forward by one page, such as PageDown, a mouse wheel, or a swipe in a carousel."@en .

ujgoperability:previousPage a owl:NamedIndividual, ujgoperability:MoveKind ;
  rdfs:label "Previous page"@en ;
  rdfs:comment "Moves the view back by one page."@en .

ujgoperability:forward a owl:NamedIndividual, ujgoperability:MaterializationDirection ;
  rdfs:label "Forward"@en ;
  rdfs:comment "Moves from the AdjacentTransition's from vertex to its to vertex. For a member AdjacentTransition, moves to the neighboring member after the border."@en .

ujgoperability:backward a owl:NamedIndividual, ujgoperability:MaterializationDirection ;
  rdfs:label "Backward"@en ;
  rdfs:comment "Moves from the AdjacentTransition's to vertex to its from vertex. For a member AdjacentTransition, moves to the neighboring member before the border."@en .

### Properties

ujgoperability:materializationTransitionRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujggraph:Transition
      ujggraph:AdjacentTransition
      ujggraph:OutgoingTransition
      ujggraph:InvokingTransition
    )
  ] ;
  rdfs:label "materialization transition ref" ;
  rdfs:comment "References the Graph transition that a TransitionMaterialization performs. A Transition with fromExitRef is taken when the child exit is reached, not by a user action, so it is never materialized." .

ujgoperability:materializationModalityRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range ujgobservability:InputModality ;
  rdfs:label "materialization modality ref" ;
  rdfs:comment "References the input modality through which a TransitionMaterialization performs its transition." .

ujgoperability:materializationStepRefs a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:label "materialization step refs" ;
  rdfs:comment "References the materialization steps of a TransitionMaterialization. The values form a set; step order comes from stepPreviousRef." .

ujgoperability:materializationStartLocatorRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgobservability:AccessibleLocator
      ujgobservability:CustomLocator
    )
  ] ;
  rdfs:label "materialization start locator ref" ;
  rdfs:comment "References a locator for the object the user is at before the first step." .

ujgoperability:materializationSourceStateRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range ujggraph:State ;
  rdfs:label "materialization source state ref" ;
  rdfs:comment "References the State in which the steps are performed when the transition does not determine it: a State that lists the materialized entry transition, or a State nested in the CompositeState that the materialized transition leaves." .

ujgoperability:materializationDirectionRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range ujgoperability:MaterializationDirection ;
  rdfs:label "materialization direction ref" ;
  rdfs:comment "References which of the two movements of the materialized AdjacentTransition a TransitionMaterialization performs." .

ujgoperability:stepPreviousRef a owl:ObjectProperty ;
  rdfs:domain [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:label "step previous ref" ;
  rdfs:comment "References the materialization step that a step follows. The first step of a materialization follows no step." .

ujgoperability:stepLocatorRef a owl:ObjectProperty ;
  rdfs:domain [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgobservability:AccessibleLocator
      ujgobservability:CustomLocator
    )
  ] ;
  rdfs:label "step locator ref" ;
  rdfs:comment "References a locator for the object that a materialization step reaches or acts on." .

ujgoperability:stepMoveKindRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:MoveStep ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:FocusMoveKind
      ujgoperability:MoveKind
    )
  ] ;
  rdfs:label "step move kind ref" ;
  rdfs:comment "References the kind of move that a MoveStep performs: a FocusMoveKind, or a MoveKind for a move that does not move focus." .
@prefix ujg: <https://ujg.specs.openuji.org/ed/ns/core#> .
@prefix ujggraph: <https://ujg.specs.openuji.org/ed/ns/graph#> .
@prefix ujgobservability: <https://ujg.specs.openuji.org/ed/ns/observability#> .
@prefix ujgoperability: <https://ujg.specs.openuji.org/ed/ns/operability#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix dct: <http://purl.org/dc/terms/> .

<https://ujg.specs.openuji.org/ed/ns/operability#> a owl:Ontology ;
  rdfs:label "UJG Operability Editor's Draft Vocabulary"@en ;
  dct:description "UJG Operability ontology declaration" .

### Classes

ujgoperability:TransitionMaterialization a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  rdfs:label "Transition Materialization" ;
  rdfs:comment "One way to perform one Graph transition through one input modality, described as materialization steps. Several materializations of the same transition are alternatives. A TransitionMaterialization does not change the transition." .

ujgoperability:MoveStep a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:ActivationStep, ujgoperability:ShortcutStep ;
  rdfs:label "Move Step" ;
  rdfs:comment "A materialization step in which the user moves to another object, such as the next button. Only the last step of a materialization takes the materialized transition." .

ujgoperability:ActivationStep a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:MoveStep, ujgoperability:ShortcutStep ;
  rdfs:label "Activation Step" ;
  rdfs:comment "A materialization step in which the user performs the default action of the object they are at: the focused object, or the object pointed at. Any of the platform's activation gestures performs it." .

ujgoperability:ShortcutStep a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:MoveStep, ujgoperability:ActivationStep ;
  rdfs:label "Shortcut Step" ;
  rdfs:comment "A materialization step in which the user performs the shortcut that an object exposes. It acts on that object without the user reaching it first." .

ujgoperability:FocusMoveKind a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:MoveKind ;
  rdfs:label "Focus Move Kind" ;
  rdfs:comment "A platform-neutral kind of focus move, used through input modalities that move focus, such as a keyboard. A platform adapter performs it with the gestures of its platform and input modality." .

ujgoperability:MoveKind a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:disjointWith ujgoperability:FocusMoveKind ;
  rdfs:label "Move Kind" ;
  rdfs:comment "A platform-neutral kind of move that does not move focus, such as moving the pointer onto an object or moving the view by a page. A platform adapter performs it with the gestures of its platform and input modality." .

ujgoperability:MaterializationDirection a owl:Class ;
  rdfs:subClassOf ujg:Node ;
  owl:equivalentClass [
    a owl:Class ;
    owl:oneOf ( ujgoperability:forward ujgoperability:backward )
  ] ;
  rdfs:label "Materialization Direction" ;
  rdfs:comment "Which of the two movements of an AdjacentTransition a TransitionMaterialization performs. An AdjacentTransition has exactly two movements, so forward and backward are the only directions." .

### Standard individuals

ujgoperability:nextStop a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Next stop"@en ;
  rdfs:comment "Moves focus to the next stop of sequential focus navigation."@en .

ujgoperability:previousStop a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Previous stop"@en ;
  rdfs:comment "Moves focus to the previous stop of sequential focus navigation."@en .

ujgoperability:nextItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Next item"@en ;
  rdfs:comment "Moves focus to the next item inside a composite widget, such as the next tab of a tab list."@en .

ujgoperability:previousItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Previous item"@en ;
  rdfs:comment "Moves focus to the previous item inside a composite widget."@en .

ujgoperability:firstItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "First item"@en ;
  rdfs:comment "Moves focus to the first item inside a composite widget."@en .

ujgoperability:lastItem a owl:NamedIndividual, ujgoperability:FocusMoveKind ;
  rdfs:label "Last item"@en ;
  rdfs:comment "Moves focus to the last item inside a composite widget."@en .

ujgoperability:pointAt a owl:NamedIndividual, ujgoperability:MoveKind ;
  rdfs:label "Point at"@en ;
  rdfs:comment "Moves the pointer onto the object that the step's locator names, such as hovering over a menu item to open its submenu."@en .

ujgoperability:nextPage a owl:NamedIndividual, ujgoperability:MoveKind ;
  rdfs:label "Next page"@en ;
  rdfs:comment "Moves the view forward by one page, such as PageDown, a mouse wheel, or a swipe in a carousel."@en .

ujgoperability:previousPage a owl:NamedIndividual, ujgoperability:MoveKind ;
  rdfs:label "Previous page"@en ;
  rdfs:comment "Moves the view back by one page."@en .

ujgoperability:forward a owl:NamedIndividual, ujgoperability:MaterializationDirection ;
  rdfs:label "Forward"@en ;
  rdfs:comment "Moves from the AdjacentTransition's from vertex to its to vertex. For a member AdjacentTransition, moves to the neighboring member after the border."@en .

ujgoperability:backward a owl:NamedIndividual, ujgoperability:MaterializationDirection ;
  rdfs:label "Backward"@en ;
  rdfs:comment "Moves from the AdjacentTransition's to vertex to its from vertex. For a member AdjacentTransition, moves to the neighboring member before the border."@en .

### Properties

ujgoperability:materializationTransitionRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujggraph:Transition
      ujggraph:AdjacentTransition
      ujggraph:OutgoingTransition
      ujggraph:InvokingTransition
    )
  ] ;
  rdfs:label "materialization transition ref" ;
  rdfs:comment "References the Graph transition that a TransitionMaterialization performs. A Transition with fromExitRef is taken when the child exit is reached, not by a user action, so it is never materialized." .

ujgoperability:materializationModalityRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range ujgobservability:InputModality ;
  rdfs:label "materialization modality ref" ;
  rdfs:comment "References the input modality through which a TransitionMaterialization performs its transition." .

ujgoperability:materializationStepRefs a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:label "materialization step refs" ;
  rdfs:comment "References the materialization steps of a TransitionMaterialization. The values form a set; step order comes from stepPreviousRef." .

ujgoperability:materializationStartLocatorRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgobservability:AccessibleLocator
      ujgobservability:CustomLocator
    )
  ] ;
  rdfs:label "materialization start locator ref" ;
  rdfs:comment "References a locator for the object the user is at before the first step." .

ujgoperability:materializationSourceStateRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range ujggraph:State ;
  rdfs:label "materialization source state ref" ;
  rdfs:comment "References the State in which the steps are performed when the transition does not determine it: a State that lists the materialized entry transition, or a State nested in the CompositeState that the materialized transition leaves." .

ujgoperability:materializationDirectionRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:TransitionMaterialization ;
  rdfs:range ujgoperability:MaterializationDirection ;
  rdfs:label "materialization direction ref" ;
  rdfs:comment "References which of the two movements of the materialized AdjacentTransition a TransitionMaterialization performs." .

ujgoperability:stepPreviousRef a owl:ObjectProperty ;
  rdfs:domain [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:label "step previous ref" ;
  rdfs:comment "References the materialization step that a step follows. The first step of a materialization follows no step." .

ujgoperability:stepLocatorRef a owl:ObjectProperty ;
  rdfs:domain [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:MoveStep
      ujgoperability:ActivationStep
      ujgoperability:ShortcutStep
    )
  ] ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgobservability:AccessibleLocator
      ujgobservability:CustomLocator
    )
  ] ;
  rdfs:label "step locator ref" ;
  rdfs:comment "References a locator for the object that a materialization step reaches or acts on." .

ujgoperability:stepMoveKindRef a owl:ObjectProperty ;
  rdfs:domain ujgoperability:MoveStep ;
  rdfs:range [
    a owl:Class ;
    owl:unionOf (
      ujgoperability:FocusMoveKind
      ujgoperability:MoveKind
    )
  ] ;
  rdfs:label "step move kind ref" ;
  rdfs:comment "References the kind of move that a MoveStep performs: a FocusMoveKind, or a MoveKind for a move that does not move focus." .

8.2. JSON-LD Context

The normative Operability JSON-LD context is defined below and is published at https://ujg.specs.openuji.org/ed/ns/operability.context.jsonld.

json-ld
{
  "@context": {
    "@version": 1.1,

    "ujgoperability": "https://ujg.specs.openuji.org/ed/ns/operability#",
    "operability": "https://ujg.specs.openuji.org/ed/ns/operability#",

    "TransitionMaterialization": "ujgoperability:TransitionMaterialization",
    "MoveStep": "ujgoperability:MoveStep",
    "ActivationStep": "ujgoperability:ActivationStep",
    "ShortcutStep": "ujgoperability:ShortcutStep",
    "FocusMoveKind": "ujgoperability:FocusMoveKind",
    "MoveKind": "ujgoperability:MoveKind",
    "MaterializationDirection": "ujgoperability:MaterializationDirection",

    "materializationTransitionRef": {
      "@id": "ujgoperability:materializationTransitionRef",
      "@type": "@id"
    },
    "materializationModalityRef": {
      "@id": "ujgoperability:materializationModalityRef",
      "@type": "@id"
    },
    "materializationStepRefs": {
      "@id": "ujgoperability:materializationStepRefs",
      "@type": "@id",
      "@container": "@set"
    },
    "materializationStartLocatorRef": {
      "@id": "ujgoperability:materializationStartLocatorRef",
      "@type": "@id"
    },
    "materializationSourceStateRef": {
      "@id": "ujgoperability:materializationSourceStateRef",
      "@type": "@id"
    },
    "materializationDirectionRef": {
      "@id": "ujgoperability:materializationDirectionRef",
      "@type": "@id"
    },
    "stepPreviousRef": {
      "@id": "ujgoperability:stepPreviousRef",
      "@type": "@id"
    },
    "stepLocatorRef": {
      "@id": "ujgoperability:stepLocatorRef",
      "@type": "@id"
    },
    "stepMoveKindRef": {
      "@id": "ujgoperability:stepMoveKindRef",
      "@type": "@id"
    }
  }
}
{
  "@context": {
    "@version": 1.1,

    "ujgoperability": "https://ujg.specs.openuji.org/ed/ns/operability#",
    "operability": "https://ujg.specs.openuji.org/ed/ns/operability#",

    "TransitionMaterialization": "ujgoperability:TransitionMaterialization",
    "MoveStep": "ujgoperability:MoveStep",
    "ActivationStep": "ujgoperability:ActivationStep",
    "ShortcutStep": "ujgoperability:ShortcutStep",
    "FocusMoveKind": "ujgoperability:FocusMoveKind",
    "MoveKind": "ujgoperability:MoveKind",
    "MaterializationDirection": "ujgoperability:MaterializationDirection",

    "materializationTransitionRef": {
      "@id": "ujgoperability:materializationTransitionRef",
      "@type": "@id"
    },
    "materializationModalityRef": {
      "@id": "ujgoperability:materializationModalityRef",
      "@type": "@id"
    },
    "materializationStepRefs": {
      "@id": "ujgoperability:materializationStepRefs",
      "@type": "@id",
      "@container": "@set"
    },
    "materializationStartLocatorRef": {
      "@id": "ujgoperability:materializationStartLocatorRef",
      "@type": "@id"
    },
    "materializationSourceStateRef": {
      "@id": "ujgoperability:materializationSourceStateRef",
      "@type": "@id"
    },
    "materializationDirectionRef": {
      "@id": "ujgoperability:materializationDirectionRef",
      "@type": "@id"
    },
    "stepPreviousRef": {
      "@id": "ujgoperability:stepPreviousRef",
      "@type": "@id"
    },
    "stepLocatorRef": {
      "@id": "ujgoperability:stepLocatorRef",
      "@type": "@id"
    },
    "stepMoveKindRef": {
      "@id": "ujgoperability:stepMoveKindRef",
      "@type": "@id"
    }
  }
}

8.3. Validation

The normative Operability SHACL shape is defined below and is published at https://ujg.specs.openuji.org/ed/ns/operability.shape.

turtle
@prefix ujggraph: <https://ujg.specs.openuji.org/ed/ns/graph#> .
@prefix ujgobservability: <https://ujg.specs.openuji.org/ed/ns/observability#> .
@prefix ujgoperability: <https://ujg.specs.openuji.org/ed/ns/operability#> .
@prefix ujgoperabilityshape: <https://ujg.specs.openuji.org/ed/ns/operability.shape#> .
@prefix sh: <http://www.w3.org/ns/shacl#> .

ujgoperabilityshape:LocatorShape a sh:NodeShape ;
  sh:nodeKind sh:IRI ;
  sh:or (
    [ sh:class ujgobservability:AccessibleLocator ]
    [ sh:class ujgobservability:CustomLocator ]
  ) .

ujgoperabilityshape:MaterializedTransitionShape a sh:NodeShape ;
  sh:nodeKind sh:IRI ;
  sh:or (
    [ sh:class ujggraph:Transition ]
    [ sh:class ujggraph:AdjacentTransition ]
    [ sh:class ujggraph:OutgoingTransition ]
    [ sh:class ujggraph:InvokingTransition ]
  ) .

ujgoperabilityshape:MaterializationStepShape a sh:NodeShape ;
  sh:nodeKind sh:IRI ;
  sh:or (
    [ sh:class ujgoperability:MoveStep ]
    [ sh:class ujgoperability:ActivationStep ]
    [ sh:class ujgoperability:ShortcutStep ]
  ) .

ujgoperabilityshape:TransitionMaterializationShape a sh:NodeShape ;
  sh:targetClass ujgoperability:TransitionMaterialization ;
  sh:nodeKind sh:IRI ;

  sh:property [
    sh:path ujgoperability:materializationTransitionRef ;
    sh:minCount 1 ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:MaterializedTransitionShape ;
    sh:message "A TransitionMaterialization must declare exactly one materializationTransitionRef that references a Transition, AdjacentTransition, OutgoingTransition, or InvokingTransition." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationModalityRef ;
    sh:minCount 1 ;
    sh:maxCount 1 ;
    sh:class ujgobservability:InputModality ;
    sh:nodeKind sh:IRI ;
    sh:message "A TransitionMaterialization must declare exactly one materializationModalityRef that references an InputModality." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationStepRefs ;
    sh:minCount 1 ;
    sh:node ujgoperabilityshape:MaterializationStepShape ;
    sh:message "A TransitionMaterialization must declare at least one materializationStepRefs value, and each must reference a MoveStep, ActivationStep, or ShortcutStep." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationStartLocatorRef ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:LocatorShape ;
    sh:message "A TransitionMaterialization may declare at most one materializationStartLocatorRef, and it must reference an AccessibleLocator or CustomLocator." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationSourceStateRef ;
    sh:maxCount 1 ;
    sh:class ujggraph:State ;
    sh:nodeKind sh:IRI ;
    sh:message "A TransitionMaterialization may declare at most one materializationSourceStateRef, and it must reference a State." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationDirectionRef ;
    sh:maxCount 1 ;
    sh:in ( ujgoperability:forward ujgoperability:backward ) ;
    sh:message "A TransitionMaterialization may declare at most one materializationDirectionRef, and it must be operability:forward or operability:backward." ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A Transition with fromExitRef is taken when the child exit is reached, not by a user action, so it has no TransitionMaterialization. Materialize the child Journey's Transition into that exit instead." ;
    sh:select """
      SELECT $this ?transition
      WHERE {
        $this ujgoperability:materializationTransitionRef ?transition .
        ?transition ujggraph:fromExitRef ?exit .
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A TransitionMaterialization of an AdjacentTransition must declare materializationDirectionRef." ;
    sh:select """
      SELECT $this ?transition
      WHERE {
        $this ujgoperability:materializationTransitionRef ?transition .
        ?transition a ujggraph:AdjacentTransition .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationDirectionRef ?direction .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Only a TransitionMaterialization of an AdjacentTransition declares materializationDirectionRef." ;
    sh:select """
      SELECT $this ?transition
      WHERE {
        $this ujgoperability:materializationDirectionRef ?direction ;
              ujgoperability:materializationTransitionRef ?transition .

        FILTER (NOT EXISTS {
          ?transition a ujggraph:AdjacentTransition .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A materializationSourceStateRef must reference a State that lists the materialized entry transition in entryTransitionRefs, or a State nested in the CompositeState that the materialized transition leaves." ;
    sh:select """
      SELECT $this ?state
      WHERE {
        $this ujgoperability:materializationSourceStateRef ?state ;
              ujgoperability:materializationTransitionRef ?transition .

        FILTER (NOT EXISTS {
          ?state ujggraph:entryTransitionRefs ?transition .
        })

        FILTER (NOT EXISTS {
          {
            ?transition a ujggraph:Transition ;
                        ujggraph:from ?left .
          }
          UNION
          {
            ?transition a ujggraph:AdjacentTransition ;
                        ujggraph:from ?left .
            $this ujgoperability:materializationDirectionRef ujgoperability:forward .
          }
          UNION
          {
            ?transition a ujggraph:AdjacentTransition ;
                        ujggraph:to ?left .
            $this ujgoperability:materializationDirectionRef ujgoperability:backward .
          }

          ?left a ujggraph:CompositeState ;
                (ujggraph:subjourneyRefs/ujggraph:stateRefs)+ ?state .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A TransitionMaterialization must have a first step: one of its materializationStepRefs values that declares no stepPreviousRef." ;
    sh:select """
      SELECT $this
      WHERE {
        $this ujgoperability:materializationStepRefs ?someStep .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationStepRefs ?first .
          FILTER (NOT EXISTS {
            ?first ujgoperability:stepPreviousRef ?previous .
          })
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A TransitionMaterialization must have exactly one first step; only one of its materializationStepRefs values may omit stepPreviousRef." ;
    sh:select """
      SELECT $this ?first
      WHERE {
        $this ujgoperability:materializationStepRefs ?first, ?otherFirst .
        FILTER (?first != ?otherFirst)

        FILTER (NOT EXISTS {
          ?first ujgoperability:stepPreviousRef ?previous .
        })
        FILTER (NOT EXISTS {
          ?otherFirst ujgoperability:stepPreviousRef ?otherPrevious .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A step's stepPreviousRef must reference a step listed in the same TransitionMaterialization's materializationStepRefs." ;
    sh:select """
      SELECT $this ?step ?previous
      WHERE {
        $this ujgoperability:materializationStepRefs ?step .
        ?step ujgoperability:stepPreviousRef ?previous .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationStepRefs ?previous .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Two steps of one TransitionMaterialization must not follow the same step." ;
    sh:select """
      SELECT $this ?previous
      WHERE {
        $this ujgoperability:materializationStepRefs ?step, ?otherStep .
        FILTER (?step != ?otherStep)

        ?step ujgoperability:stepPreviousRef ?previous .
        ?otherStep ujgoperability:stepPreviousRef ?previous .
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A pointer moves directly to an object, so a MoveStep of a TransitionMaterialization through observability:pointer must not use a FocusMoveKind." ;
    sh:select """
      SELECT $this ?step ?kind
      WHERE {
        $this ujgoperability:materializationModalityRef ujgobservability:pointer ;
              ujgoperability:materializationStepRefs ?step .
        ?step ujgoperability:stepMoveKindRef ?kind .
        ?kind a ujgoperability:FocusMoveKind .
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Only a TransitionMaterialization through observability:pointer uses operability:pointAt." ;
    sh:select """
      SELECT $this ?step
      WHERE {
        $this ujgoperability:materializationStepRefs ?step .
        ?step ujgoperability:stepMoveKindRef ujgoperability:pointAt .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationModalityRef ujgobservability:pointer .
        })
      }
    """ ;
  ] .

ujgoperabilityshape:MoveStepShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MoveStep ;
  sh:nodeKind sh:IRI ;
  sh:not [ sh:class ujgoperability:ActivationStep ] ;
  sh:not [ sh:class ujgoperability:ShortcutStep ] ;
  sh:message "A MoveStep must be identified by an IRI and must not also be an ActivationStep or ShortcutStep." ;

  sh:property [
    sh:path ujgoperability:stepMoveKindRef ;
    sh:maxCount 1 ;
    sh:nodeKind sh:IRI ;
    sh:or (
      [ sh:class ujgoperability:FocusMoveKind ]
      [ sh:class ujgoperability:MoveKind ]
    ) ;
    sh:message "A MoveStep may declare at most one stepMoveKindRef, and it must reference a FocusMoveKind or a MoveKind." ;
  ] .

ujgoperabilityshape:ActivationStepShape a sh:NodeShape ;
  sh:targetClass ujgoperability:ActivationStep ;
  sh:nodeKind sh:IRI ;
  sh:not [ sh:class ujgoperability:ShortcutStep ] ;
  sh:message "An ActivationStep must be identified by an IRI and must not also be a ShortcutStep." .

ujgoperabilityshape:MaterializationStepPropertiesShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MoveStep, ujgoperability:ActivationStep, ujgoperability:ShortcutStep ;

  sh:property [
    sh:path ujgoperability:stepLocatorRef ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:LocatorShape ;
    sh:message "A materialization step may declare at most one stepLocatorRef, and it must reference an AccessibleLocator or CustomLocator." ;
  ] ;

  sh:property [
    sh:path ujgoperability:stepPreviousRef ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:MaterializationStepShape ;
    sh:message "A materialization step may declare at most one stepPreviousRef, and it must reference a MoveStep, ActivationStep, or ShortcutStep." ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A materialization step must be listed in exactly one TransitionMaterialization's materializationStepRefs." ;
    sh:select """
      SELECT $this
      WHERE {
        FILTER (NOT EXISTS {
          ?materialization ujgoperability:materializationStepRefs $this .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A materialization step must be listed in exactly one TransitionMaterialization's materializationStepRefs." ;
    sh:select """
      SELECT $this ?materialization
      WHERE {
        ?materialization ujgoperability:materializationStepRefs $this .
        ?otherMaterialization ujgoperability:materializationStepRefs $this .
        FILTER (?materialization != ?otherMaterialization)
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Materialization steps must not follow each other in a cycle." ;
    sh:select """
      SELECT $this
      WHERE {
        $this ujgoperability:stepPreviousRef+ $this .
      }
    """ ;
  ] .

ujgoperabilityshape:FocusMoveKindShape a sh:NodeShape ;
  sh:targetClass ujgoperability:FocusMoveKind ;
  sh:nodeKind sh:IRI ;
  sh:not [ sh:class ujgoperability:MoveKind ] ;
  sh:message "A FocusMoveKind must be identified by an IRI and must not also be a MoveKind." .

ujgoperabilityshape:MoveKindShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MoveKind ;
  sh:nodeKind sh:IRI .

ujgoperabilityshape:MaterializationDirectionShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MaterializationDirection ;
  sh:nodeKind sh:IRI ;
  sh:in ( ujgoperability:forward ujgoperability:backward ) ;
  sh:message "A MaterializationDirection must be operability:forward or operability:backward." .

ujgoperabilityshape:MaterializationTransitionRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationTransitionRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationTransitionRef." .

ujgoperabilityshape:MaterializationModalityRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationModalityRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationModalityRef." .

ujgoperabilityshape:MaterializationStepRefsSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationStepRefs ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationStepRefs." .

ujgoperabilityshape:MaterializationStartLocatorRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationStartLocatorRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationStartLocatorRef." .

ujgoperabilityshape:MaterializationSourceStateRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationSourceStateRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationSourceStateRef." .

ujgoperabilityshape:MaterializationDirectionRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationDirectionRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationDirectionRef." .

ujgoperabilityshape:StepPreviousRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:stepPreviousRef ;
  sh:node ujgoperabilityshape:MaterializationStepShape ;
  sh:message "Only a MoveStep, ActivationStep, or ShortcutStep declares stepPreviousRef." .

ujgoperabilityshape:StepLocatorRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:stepLocatorRef ;
  sh:node ujgoperabilityshape:MaterializationStepShape ;
  sh:message "Only a MoveStep, ActivationStep, or ShortcutStep declares stepLocatorRef." .

ujgoperabilityshape:StepMoveKindRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:stepMoveKindRef ;
  sh:class ujgoperability:MoveStep ;
  sh:message "Only a MoveStep declares stepMoveKindRef." .
@prefix ujggraph: <https://ujg.specs.openuji.org/ed/ns/graph#> .
@prefix ujgobservability: <https://ujg.specs.openuji.org/ed/ns/observability#> .
@prefix ujgoperability: <https://ujg.specs.openuji.org/ed/ns/operability#> .
@prefix ujgoperabilityshape: <https://ujg.specs.openuji.org/ed/ns/operability.shape#> .
@prefix sh: <http://www.w3.org/ns/shacl#> .

ujgoperabilityshape:LocatorShape a sh:NodeShape ;
  sh:nodeKind sh:IRI ;
  sh:or (
    [ sh:class ujgobservability:AccessibleLocator ]
    [ sh:class ujgobservability:CustomLocator ]
  ) .

ujgoperabilityshape:MaterializedTransitionShape a sh:NodeShape ;
  sh:nodeKind sh:IRI ;
  sh:or (
    [ sh:class ujggraph:Transition ]
    [ sh:class ujggraph:AdjacentTransition ]
    [ sh:class ujggraph:OutgoingTransition ]
    [ sh:class ujggraph:InvokingTransition ]
  ) .

ujgoperabilityshape:MaterializationStepShape a sh:NodeShape ;
  sh:nodeKind sh:IRI ;
  sh:or (
    [ sh:class ujgoperability:MoveStep ]
    [ sh:class ujgoperability:ActivationStep ]
    [ sh:class ujgoperability:ShortcutStep ]
  ) .

ujgoperabilityshape:TransitionMaterializationShape a sh:NodeShape ;
  sh:targetClass ujgoperability:TransitionMaterialization ;
  sh:nodeKind sh:IRI ;

  sh:property [
    sh:path ujgoperability:materializationTransitionRef ;
    sh:minCount 1 ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:MaterializedTransitionShape ;
    sh:message "A TransitionMaterialization must declare exactly one materializationTransitionRef that references a Transition, AdjacentTransition, OutgoingTransition, or InvokingTransition." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationModalityRef ;
    sh:minCount 1 ;
    sh:maxCount 1 ;
    sh:class ujgobservability:InputModality ;
    sh:nodeKind sh:IRI ;
    sh:message "A TransitionMaterialization must declare exactly one materializationModalityRef that references an InputModality." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationStepRefs ;
    sh:minCount 1 ;
    sh:node ujgoperabilityshape:MaterializationStepShape ;
    sh:message "A TransitionMaterialization must declare at least one materializationStepRefs value, and each must reference a MoveStep, ActivationStep, or ShortcutStep." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationStartLocatorRef ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:LocatorShape ;
    sh:message "A TransitionMaterialization may declare at most one materializationStartLocatorRef, and it must reference an AccessibleLocator or CustomLocator." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationSourceStateRef ;
    sh:maxCount 1 ;
    sh:class ujggraph:State ;
    sh:nodeKind sh:IRI ;
    sh:message "A TransitionMaterialization may declare at most one materializationSourceStateRef, and it must reference a State." ;
  ] ;

  sh:property [
    sh:path ujgoperability:materializationDirectionRef ;
    sh:maxCount 1 ;
    sh:in ( ujgoperability:forward ujgoperability:backward ) ;
    sh:message "A TransitionMaterialization may declare at most one materializationDirectionRef, and it must be operability:forward or operability:backward." ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A Transition with fromExitRef is taken when the child exit is reached, not by a user action, so it has no TransitionMaterialization. Materialize the child Journey's Transition into that exit instead." ;
    sh:select """
      SELECT $this ?transition
      WHERE {
        $this ujgoperability:materializationTransitionRef ?transition .
        ?transition ujggraph:fromExitRef ?exit .
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A TransitionMaterialization of an AdjacentTransition must declare materializationDirectionRef." ;
    sh:select """
      SELECT $this ?transition
      WHERE {
        $this ujgoperability:materializationTransitionRef ?transition .
        ?transition a ujggraph:AdjacentTransition .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationDirectionRef ?direction .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Only a TransitionMaterialization of an AdjacentTransition declares materializationDirectionRef." ;
    sh:select """
      SELECT $this ?transition
      WHERE {
        $this ujgoperability:materializationDirectionRef ?direction ;
              ujgoperability:materializationTransitionRef ?transition .

        FILTER (NOT EXISTS {
          ?transition a ujggraph:AdjacentTransition .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A materializationSourceStateRef must reference a State that lists the materialized entry transition in entryTransitionRefs, or a State nested in the CompositeState that the materialized transition leaves." ;
    sh:select """
      SELECT $this ?state
      WHERE {
        $this ujgoperability:materializationSourceStateRef ?state ;
              ujgoperability:materializationTransitionRef ?transition .

        FILTER (NOT EXISTS {
          ?state ujggraph:entryTransitionRefs ?transition .
        })

        FILTER (NOT EXISTS {
          {
            ?transition a ujggraph:Transition ;
                        ujggraph:from ?left .
          }
          UNION
          {
            ?transition a ujggraph:AdjacentTransition ;
                        ujggraph:from ?left .
            $this ujgoperability:materializationDirectionRef ujgoperability:forward .
          }
          UNION
          {
            ?transition a ujggraph:AdjacentTransition ;
                        ujggraph:to ?left .
            $this ujgoperability:materializationDirectionRef ujgoperability:backward .
          }

          ?left a ujggraph:CompositeState ;
                (ujggraph:subjourneyRefs/ujggraph:stateRefs)+ ?state .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A TransitionMaterialization must have a first step: one of its materializationStepRefs values that declares no stepPreviousRef." ;
    sh:select """
      SELECT $this
      WHERE {
        $this ujgoperability:materializationStepRefs ?someStep .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationStepRefs ?first .
          FILTER (NOT EXISTS {
            ?first ujgoperability:stepPreviousRef ?previous .
          })
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A TransitionMaterialization must have exactly one first step; only one of its materializationStepRefs values may omit stepPreviousRef." ;
    sh:select """
      SELECT $this ?first
      WHERE {
        $this ujgoperability:materializationStepRefs ?first, ?otherFirst .
        FILTER (?first != ?otherFirst)

        FILTER (NOT EXISTS {
          ?first ujgoperability:stepPreviousRef ?previous .
        })
        FILTER (NOT EXISTS {
          ?otherFirst ujgoperability:stepPreviousRef ?otherPrevious .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A step's stepPreviousRef must reference a step listed in the same TransitionMaterialization's materializationStepRefs." ;
    sh:select """
      SELECT $this ?step ?previous
      WHERE {
        $this ujgoperability:materializationStepRefs ?step .
        ?step ujgoperability:stepPreviousRef ?previous .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationStepRefs ?previous .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Two steps of one TransitionMaterialization must not follow the same step." ;
    sh:select """
      SELECT $this ?previous
      WHERE {
        $this ujgoperability:materializationStepRefs ?step, ?otherStep .
        FILTER (?step != ?otherStep)

        ?step ujgoperability:stepPreviousRef ?previous .
        ?otherStep ujgoperability:stepPreviousRef ?previous .
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A pointer moves directly to an object, so a MoveStep of a TransitionMaterialization through observability:pointer must not use a FocusMoveKind." ;
    sh:select """
      SELECT $this ?step ?kind
      WHERE {
        $this ujgoperability:materializationModalityRef ujgobservability:pointer ;
              ujgoperability:materializationStepRefs ?step .
        ?step ujgoperability:stepMoveKindRef ?kind .
        ?kind a ujgoperability:FocusMoveKind .
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Only a TransitionMaterialization through observability:pointer uses operability:pointAt." ;
    sh:select """
      SELECT $this ?step
      WHERE {
        $this ujgoperability:materializationStepRefs ?step .
        ?step ujgoperability:stepMoveKindRef ujgoperability:pointAt .

        FILTER (NOT EXISTS {
          $this ujgoperability:materializationModalityRef ujgobservability:pointer .
        })
      }
    """ ;
  ] .

ujgoperabilityshape:MoveStepShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MoveStep ;
  sh:nodeKind sh:IRI ;
  sh:not [ sh:class ujgoperability:ActivationStep ] ;
  sh:not [ sh:class ujgoperability:ShortcutStep ] ;
  sh:message "A MoveStep must be identified by an IRI and must not also be an ActivationStep or ShortcutStep." ;

  sh:property [
    sh:path ujgoperability:stepMoveKindRef ;
    sh:maxCount 1 ;
    sh:nodeKind sh:IRI ;
    sh:or (
      [ sh:class ujgoperability:FocusMoveKind ]
      [ sh:class ujgoperability:MoveKind ]
    ) ;
    sh:message "A MoveStep may declare at most one stepMoveKindRef, and it must reference a FocusMoveKind or a MoveKind." ;
  ] .

ujgoperabilityshape:ActivationStepShape a sh:NodeShape ;
  sh:targetClass ujgoperability:ActivationStep ;
  sh:nodeKind sh:IRI ;
  sh:not [ sh:class ujgoperability:ShortcutStep ] ;
  sh:message "An ActivationStep must be identified by an IRI and must not also be a ShortcutStep." .

ujgoperabilityshape:MaterializationStepPropertiesShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MoveStep, ujgoperability:ActivationStep, ujgoperability:ShortcutStep ;

  sh:property [
    sh:path ujgoperability:stepLocatorRef ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:LocatorShape ;
    sh:message "A materialization step may declare at most one stepLocatorRef, and it must reference an AccessibleLocator or CustomLocator." ;
  ] ;

  sh:property [
    sh:path ujgoperability:stepPreviousRef ;
    sh:maxCount 1 ;
    sh:node ujgoperabilityshape:MaterializationStepShape ;
    sh:message "A materialization step may declare at most one stepPreviousRef, and it must reference a MoveStep, ActivationStep, or ShortcutStep." ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A materialization step must be listed in exactly one TransitionMaterialization's materializationStepRefs." ;
    sh:select """
      SELECT $this
      WHERE {
        FILTER (NOT EXISTS {
          ?materialization ujgoperability:materializationStepRefs $this .
        })
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "A materialization step must be listed in exactly one TransitionMaterialization's materializationStepRefs." ;
    sh:select """
      SELECT $this ?materialization
      WHERE {
        ?materialization ujgoperability:materializationStepRefs $this .
        ?otherMaterialization ujgoperability:materializationStepRefs $this .
        FILTER (?materialization != ?otherMaterialization)
      }
    """ ;
  ] ;

  sh:sparql [
    a sh:SPARQLConstraint ;
    sh:message "Materialization steps must not follow each other in a cycle." ;
    sh:select """
      SELECT $this
      WHERE {
        $this ujgoperability:stepPreviousRef+ $this .
      }
    """ ;
  ] .

ujgoperabilityshape:FocusMoveKindShape a sh:NodeShape ;
  sh:targetClass ujgoperability:FocusMoveKind ;
  sh:nodeKind sh:IRI ;
  sh:not [ sh:class ujgoperability:MoveKind ] ;
  sh:message "A FocusMoveKind must be identified by an IRI and must not also be a MoveKind." .

ujgoperabilityshape:MoveKindShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MoveKind ;
  sh:nodeKind sh:IRI .

ujgoperabilityshape:MaterializationDirectionShape a sh:NodeShape ;
  sh:targetClass ujgoperability:MaterializationDirection ;
  sh:nodeKind sh:IRI ;
  sh:in ( ujgoperability:forward ujgoperability:backward ) ;
  sh:message "A MaterializationDirection must be operability:forward or operability:backward." .

ujgoperabilityshape:MaterializationTransitionRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationTransitionRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationTransitionRef." .

ujgoperabilityshape:MaterializationModalityRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationModalityRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationModalityRef." .

ujgoperabilityshape:MaterializationStepRefsSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationStepRefs ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationStepRefs." .

ujgoperabilityshape:MaterializationStartLocatorRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationStartLocatorRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationStartLocatorRef." .

ujgoperabilityshape:MaterializationSourceStateRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationSourceStateRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationSourceStateRef." .

ujgoperabilityshape:MaterializationDirectionRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:materializationDirectionRef ;
  sh:class ujgoperability:TransitionMaterialization ;
  sh:message "Only a TransitionMaterialization declares materializationDirectionRef." .

ujgoperabilityshape:StepPreviousRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:stepPreviousRef ;
  sh:node ujgoperabilityshape:MaterializationStepShape ;
  sh:message "Only a MoveStep, ActivationStep, or ShortcutStep declares stepPreviousRef." .

ujgoperabilityshape:StepLocatorRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:stepLocatorRef ;
  sh:node ujgoperabilityshape:MaterializationStepShape ;
  sh:message "Only a MoveStep, ActivationStep, or ShortcutStep declares stepLocatorRef." .

ujgoperabilityshape:StepMoveKindRefSubjectShape a sh:NodeShape ;
  sh:targetSubjectsOf ujgoperability:stepMoveKindRef ;
  sh:class ujgoperability:MoveStep ;
  sh:message "Only a MoveStep declares stepMoveKindRef." .

The remaining module semantics beyond the structural SHACL constraints are:

  1. No Graph change: Operability properties MUST NOT change Graph validity, graph traversal, import resolution, or core node identity.

  2. No Observability change: Operability MUST NOT change how an ObservationBinding recognizes a Surface or what requiredInputModalityProfileRefs requires.

  3. Graceful degradation: Consumers that do not implement Operability semantics MAY ignore Operability data, but SHOULD preserve recognized JSON-LD data during read-transform-write when possible.

9. Examples

9.1. Mail Tabs Example

"Select Drafts" takes the user from "Home selected" to "Drafts selected". The example gives it three materializations:

  • By keyboard, the user moves focus past a button that sits before the tab list, onto the Home tab, past the Inbox tab, and onto the Drafts tab, and then activates it. Only two of the four moves name the object they reach.

  • By pointer, the user points at the Drafts tab and activates it.

  • By shortcut, the user performs the shortcut that the Drafts tab exposes.

The example does not name where the keyboard steps start. All three materializations are performable: every MoveStep names its kind, the step that points names the Drafts tab, and the shortcut step names the tab that exposes the shortcut.

json
{
  "@context": [
    "https://ujg.specs.openuji.org/ed/ns/context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/surface.context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/l10n.context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/observability.context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/operability.context.jsonld"
  ],
  "@id": "https://example.com/ujg/operability/mail-tabs.jsonld",
  "@type": "UJGDocument",
  "nodes": [
    {
      "@type": "Journey",
      "@id": "urn:journey:mail",
      "label": "Mail",
      "defaultEntryRef": "urn:entry:mail",
      "entryRefs": ["urn:entry:mail"],
      "stateRefs": ["urn:state:home-selected", "urn:state:drafts-selected"],
      "transitionRefs": ["urn:transition:select-drafts"]
    },
    {
      "@type": "JourneyEntry",
      "@id": "urn:entry:mail",
      "stateRef": "urn:state:home-selected"
    },
    {
      "@type": "State",
      "@id": "urn:state:home-selected",
      "label": "Home selected"
    },
    {
      "@type": "State",
      "@id": "urn:state:drafts-selected",
      "label": "Drafts selected"
    },
    {
      "@type": "Transition",
      "@id": "urn:transition:select-drafts",
      "label": "Select Drafts",
      "from": "urn:state:home-selected",
      "to": "urn:state:drafts-selected",
      "commandRef": "urn:command:select-drafts"
    },
    {
      "@type": "Command",
      "@id": "urn:command:select-drafts",
      "label": "Select Drafts"
    },
    {
      "@type": "Surface",
      "@id": "urn:surface:select-drafts",
      "graphNodeRef": "urn:command:select-drafts"
    },
    {
      "@type": "Locale",
      "@id": "urn:locale:en",
      "localeCode": "en"
    },
    {
      "@type": "MessageMeta",
      "@id": "urn:message-meta:home",
      "defaultLocaleRef": "urn:locale:en"
    },
    {
      "@type": "Message",
      "@id": "urn:message:home:en",
      "messageMetaRef": "urn:message-meta:home",
      "localeRef": "urn:locale:en",
      "value": "Home"
    },
    {
      "@type": "MessageMeta",
      "@id": "urn:message-meta:drafts",
      "defaultLocaleRef": "urn:locale:en"
    },
    {
      "@type": "Message",
      "@id": "urn:message:drafts:en",
      "messageMetaRef": "urn:message-meta:drafts",
      "localeRef": "urn:locale:en",
      "value": "Drafts"
    },
    {
      "@type": "AccessibleLocator",
      "@id": "urn:locator:mail-tablist",
      "role": "tablist"
    },
    {
      "@type": "AccessibleLocator",
      "@id": "urn:locator:home-tab",
      "role": "tab",
      "accessibleNameRef": "urn:message-meta:home",
      "contextLocatorRefs": ["urn:locator:mail-tablist"]
    },
    {
      "@type": "AccessibleLocator",
      "@id": "urn:locator:drafts-tab",
      "role": "tab",
      "accessibleNameRef": "urn:message-meta:drafts",
      "contextLocatorRefs": ["urn:locator:mail-tablist"]
    },
    {
      "@type": "InputModalityProfile",
      "@id": "urn:input-modality-profile:keyboard",
      "label": "Keyboard",
      "inputModalityRefs": ["observability:keyboard"]
    },
    {
      "@type": "InputModalityProfile",
      "@id": "urn:input-modality-profile:pointer",
      "label": "Pointer",
      "inputModalityRefs": ["observability:pointer"]
    },
    {
      "@type": "ObservationEvent",
      "@id": "urn:observation-event:select-drafts-activation",
      "label": "Select Drafts activation",
      "requiredInputModalityProfileRefs": [
        "urn:input-modality-profile:keyboard",
        "urn:input-modality-profile:pointer"
      ]
    },
    {
      "@type": "ObservationBinding",
      "@id": "urn:binding:select-drafts-activation",
      "observeSurfaceRef": "urn:surface:select-drafts",
      "observationEventRef": "urn:observation-event:select-drafts-activation",
      "locatorRefs": ["urn:locator:drafts-tab"]
    },
    {
      "@type": "TransitionMaterialization",
      "@id": "urn:materialization:select-drafts:keyboard",
      "label": "Select Drafts by keyboard",
      "materializationTransitionRef": "urn:transition:select-drafts",
      "materializationModalityRef": "observability:keyboard",
      "materializationStepRefs": [
        "urn:step:select-drafts:keyboard:1",
        "urn:step:select-drafts:keyboard:2",
        "urn:step:select-drafts:keyboard:3",
        "urn:step:select-drafts:keyboard:4",
        "urn:step:select-drafts:keyboard:5"
      ]
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:1",
      "stepMoveKindRef": "operability:nextStop"
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:2",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:1",
      "stepMoveKindRef": "operability:nextStop",
      "stepLocatorRef": "urn:locator:home-tab"
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:3",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:2",
      "stepMoveKindRef": "operability:nextItem"
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:4",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:3",
      "stepMoveKindRef": "operability:nextItem",
      "stepLocatorRef": "urn:locator:drafts-tab"
    },
    {
      "@type": "ActivationStep",
      "@id": "urn:step:select-drafts:keyboard:5",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:4"
    },
    {
      "@type": "TransitionMaterialization",
      "@id": "urn:materialization:select-drafts:pointer",
      "label": "Select Drafts by pointer",
      "materializationTransitionRef": "urn:transition:select-drafts",
      "materializationModalityRef": "observability:pointer",
      "materializationStepRefs": [
        "urn:step:select-drafts:pointer:1",
        "urn:step:select-drafts:pointer:2"
      ]
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:pointer:1",
      "stepMoveKindRef": "operability:pointAt",
      "stepLocatorRef": "urn:locator:drafts-tab"
    },
    {
      "@type": "ActivationStep",
      "@id": "urn:step:select-drafts:pointer:2",
      "stepPreviousRef": "urn:step:select-drafts:pointer:1"
    },
    {
      "@type": "TransitionMaterialization",
      "@id": "urn:materialization:select-drafts:shortcut",
      "label": "Select Drafts by shortcut",
      "materializationTransitionRef": "urn:transition:select-drafts",
      "materializationModalityRef": "observability:keyboard",
      "materializationStepRefs": ["urn:step:select-drafts:shortcut:1"]
    },
    {
      "@type": "ShortcutStep",
      "@id": "urn:step:select-drafts:shortcut:1",
      "stepLocatorRef": "urn:locator:drafts-tab"
    }
  ]
}
{
  "@context": [
    "https://ujg.specs.openuji.org/ed/ns/context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/surface.context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/l10n.context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/observability.context.jsonld",
    "https://ujg.specs.openuji.org/ed/ns/operability.context.jsonld"
  ],
  "@id": "https://example.com/ujg/operability/mail-tabs.jsonld",
  "@type": "UJGDocument",
  "nodes": [
    {
      "@type": "Journey",
      "@id": "urn:journey:mail",
      "label": "Mail",
      "defaultEntryRef": "urn:entry:mail",
      "entryRefs": ["urn:entry:mail"],
      "stateRefs": ["urn:state:home-selected", "urn:state:drafts-selected"],
      "transitionRefs": ["urn:transition:select-drafts"]
    },
    {
      "@type": "JourneyEntry",
      "@id": "urn:entry:mail",
      "stateRef": "urn:state:home-selected"
    },
    {
      "@type": "State",
      "@id": "urn:state:home-selected",
      "label": "Home selected"
    },
    {
      "@type": "State",
      "@id": "urn:state:drafts-selected",
      "label": "Drafts selected"
    },
    {
      "@type": "Transition",
      "@id": "urn:transition:select-drafts",
      "label": "Select Drafts",
      "from": "urn:state:home-selected",
      "to": "urn:state:drafts-selected",
      "commandRef": "urn:command:select-drafts"
    },
    {
      "@type": "Command",
      "@id": "urn:command:select-drafts",
      "label": "Select Drafts"
    },
    {
      "@type": "Surface",
      "@id": "urn:surface:select-drafts",
      "graphNodeRef": "urn:command:select-drafts"
    },
    {
      "@type": "Locale",
      "@id": "urn:locale:en",
      "localeCode": "en"
    },
    {
      "@type": "MessageMeta",
      "@id": "urn:message-meta:home",
      "defaultLocaleRef": "urn:locale:en"
    },
    {
      "@type": "Message",
      "@id": "urn:message:home:en",
      "messageMetaRef": "urn:message-meta:home",
      "localeRef": "urn:locale:en",
      "value": "Home"
    },
    {
      "@type": "MessageMeta",
      "@id": "urn:message-meta:drafts",
      "defaultLocaleRef": "urn:locale:en"
    },
    {
      "@type": "Message",
      "@id": "urn:message:drafts:en",
      "messageMetaRef": "urn:message-meta:drafts",
      "localeRef": "urn:locale:en",
      "value": "Drafts"
    },
    {
      "@type": "AccessibleLocator",
      "@id": "urn:locator:mail-tablist",
      "role": "tablist"
    },
    {
      "@type": "AccessibleLocator",
      "@id": "urn:locator:home-tab",
      "role": "tab",
      "accessibleNameRef": "urn:message-meta:home",
      "contextLocatorRefs": ["urn:locator:mail-tablist"]
    },
    {
      "@type": "AccessibleLocator",
      "@id": "urn:locator:drafts-tab",
      "role": "tab",
      "accessibleNameRef": "urn:message-meta:drafts",
      "contextLocatorRefs": ["urn:locator:mail-tablist"]
    },
    {
      "@type": "InputModalityProfile",
      "@id": "urn:input-modality-profile:keyboard",
      "label": "Keyboard",
      "inputModalityRefs": ["observability:keyboard"]
    },
    {
      "@type": "InputModalityProfile",
      "@id": "urn:input-modality-profile:pointer",
      "label": "Pointer",
      "inputModalityRefs": ["observability:pointer"]
    },
    {
      "@type": "ObservationEvent",
      "@id": "urn:observation-event:select-drafts-activation",
      "label": "Select Drafts activation",
      "requiredInputModalityProfileRefs": [
        "urn:input-modality-profile:keyboard",
        "urn:input-modality-profile:pointer"
      ]
    },
    {
      "@type": "ObservationBinding",
      "@id": "urn:binding:select-drafts-activation",
      "observeSurfaceRef": "urn:surface:select-drafts",
      "observationEventRef": "urn:observation-event:select-drafts-activation",
      "locatorRefs": ["urn:locator:drafts-tab"]
    },
    {
      "@type": "TransitionMaterialization",
      "@id": "urn:materialization:select-drafts:keyboard",
      "label": "Select Drafts by keyboard",
      "materializationTransitionRef": "urn:transition:select-drafts",
      "materializationModalityRef": "observability:keyboard",
      "materializationStepRefs": [
        "urn:step:select-drafts:keyboard:1",
        "urn:step:select-drafts:keyboard:2",
        "urn:step:select-drafts:keyboard:3",
        "urn:step:select-drafts:keyboard:4",
        "urn:step:select-drafts:keyboard:5"
      ]
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:1",
      "stepMoveKindRef": "operability:nextStop"
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:2",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:1",
      "stepMoveKindRef": "operability:nextStop",
      "stepLocatorRef": "urn:locator:home-tab"
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:3",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:2",
      "stepMoveKindRef": "operability:nextItem"
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:keyboard:4",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:3",
      "stepMoveKindRef": "operability:nextItem",
      "stepLocatorRef": "urn:locator:drafts-tab"
    },
    {
      "@type": "ActivationStep",
      "@id": "urn:step:select-drafts:keyboard:5",
      "stepPreviousRef": "urn:step:select-drafts:keyboard:4"
    },
    {
      "@type": "TransitionMaterialization",
      "@id": "urn:materialization:select-drafts:pointer",
      "label": "Select Drafts by pointer",
      "materializationTransitionRef": "urn:transition:select-drafts",
      "materializationModalityRef": "observability:pointer",
      "materializationStepRefs": [
        "urn:step:select-drafts:pointer:1",
        "urn:step:select-drafts:pointer:2"
      ]
    },
    {
      "@type": "MoveStep",
      "@id": "urn:step:select-drafts:pointer:1",
      "stepMoveKindRef": "operability:pointAt",
      "stepLocatorRef": "urn:locator:drafts-tab"
    },
    {
      "@type": "ActivationStep",
      "@id": "urn:step:select-drafts:pointer:2",
      "stepPreviousRef": "urn:step:select-drafts:pointer:1"
    },
    {
      "@type": "TransitionMaterialization",
      "@id": "urn:materialization:select-drafts:shortcut",
      "label": "Select Drafts by shortcut",
      "materializationTransitionRef": "urn:transition:select-drafts",
      "materializationModalityRef": "observability:keyboard",
      "materializationStepRefs": ["urn:step:select-drafts:shortcut:1"]
    },
    {
      "@type": "ShortcutStep",
      "@id": "urn:step:select-drafts:shortcut:1",
      "stepLocatorRef": "urn:locator:drafts-tab"
    }
  ]
}

The binding observes the Surface of the "Select Drafts" Command, and its activation event requires two profiles. Each profile is checked on its own:

  • The keyboard profile can be checked with urn:materialization:select-drafts:keyboard, or with urn:materialization:select-drafts:shortcut, which also uses the keyboard.

  • The pointer profile can be checked with urn:materialization:select-drafts:pointer.

9.2. Selection Follows Focus Example

In some tab lists, moving focus to a tab also selects it. A keyboard user who goes from Home to Drafts then passes through Inbox, which is a State of its own. The Graph has two more transitions, "Select Inbox" from Home and "Select Drafts" from Inbox, and each one gets a keyboard materialization whose last step is a MoveStep. The second one starts at the Inbox tab.

The Home → Drafts transition keeps its pointer and shortcut materializations from the previous example. It has no keyboard materialization in this tab list: a keyboard user cannot reach Drafts from Home without passing Inbox, so those steps would pass through another State.

To turn the previous example into this one:

  • remove urn:materialization:select-drafts:keyboard and its five steps;

  • replace the urn:journey:mail node with the one below, which lists the new State and Transitions;

  • add the other nodes below.

json
[
  {
    "@type": "Journey",
    "@id": "urn:journey:mail",
    "label": "Mail",
    "defaultEntryRef": "urn:entry:mail",
    "entryRefs": ["urn:entry:mail"],
    "stateRefs": [
      "urn:state:home-selected",
      "urn:state:inbox-selected",
      "urn:state:drafts-selected"
    ],
    "transitionRefs": [
      "urn:transition:select-drafts",
      "urn:transition:select-inbox",
      "urn:transition:select-drafts-from-inbox"
    ]
  },
  {
    "@type": "State",
    "@id": "urn:state:inbox-selected",
    "label": "Inbox selected"
  },
  {
    "@type": "Transition",
    "@id": "urn:transition:select-inbox",
    "label": "Select Inbox",
    "from": "urn:state:home-selected",
    "to": "urn:state:inbox-selected",
    "commandRef": "urn:command:select-inbox"
  },
  {
    "@type": "Transition",
    "@id": "urn:transition:select-drafts-from-inbox",
    "label": "Select Drafts",
    "from": "urn:state:inbox-selected",
    "to": "urn:state:drafts-selected",
    "commandRef": "urn:command:select-drafts"
  },
  {
    "@type": "Command",
    "@id": "urn:command:select-inbox",
    "label": "Select Inbox"
  },
  {
    "@type": "MessageMeta",
    "@id": "urn:message-meta:inbox",
    "defaultLocaleRef": "urn:locale:en"
  },
  {
    "@type": "Message",
    "@id": "urn:message:inbox:en",
    "messageMetaRef": "urn:message-meta:inbox",
    "localeRef": "urn:locale:en",
    "value": "Inbox"
  },
  {
    "@type": "AccessibleLocator",
    "@id": "urn:locator:inbox-tab",
    "role": "tab",
    "accessibleNameRef": "urn:message-meta:inbox",
    "contextLocatorRefs": ["urn:locator:mail-tablist"]
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:select-inbox:keyboard",
    "materializationTransitionRef": "urn:transition:select-inbox",
    "materializationModalityRef": "observability:keyboard",
    "materializationStepRefs": [
      "urn:step:select-inbox:keyboard:1",
      "urn:step:select-inbox:keyboard:2",
      "urn:step:select-inbox:keyboard:3"
    ]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-inbox:keyboard:1",
    "stepMoveKindRef": "operability:nextStop"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-inbox:keyboard:2",
    "stepPreviousRef": "urn:step:select-inbox:keyboard:1",
    "stepMoveKindRef": "operability:nextStop",
    "stepLocatorRef": "urn:locator:home-tab"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-inbox:keyboard:3",
    "stepPreviousRef": "urn:step:select-inbox:keyboard:2",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:locator:inbox-tab"
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:select-drafts-from-inbox:keyboard",
    "materializationTransitionRef": "urn:transition:select-drafts-from-inbox",
    "materializationModalityRef": "observability:keyboard",
    "materializationStartLocatorRef": "urn:locator:inbox-tab",
    "materializationStepRefs": ["urn:step:select-drafts-from-inbox:keyboard:1"]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-drafts-from-inbox:keyboard:1",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:locator:drafts-tab"
  }
]
[
  {
    "@type": "Journey",
    "@id": "urn:journey:mail",
    "label": "Mail",
    "defaultEntryRef": "urn:entry:mail",
    "entryRefs": ["urn:entry:mail"],
    "stateRefs": [
      "urn:state:home-selected",
      "urn:state:inbox-selected",
      "urn:state:drafts-selected"
    ],
    "transitionRefs": [
      "urn:transition:select-drafts",
      "urn:transition:select-inbox",
      "urn:transition:select-drafts-from-inbox"
    ]
  },
  {
    "@type": "State",
    "@id": "urn:state:inbox-selected",
    "label": "Inbox selected"
  },
  {
    "@type": "Transition",
    "@id": "urn:transition:select-inbox",
    "label": "Select Inbox",
    "from": "urn:state:home-selected",
    "to": "urn:state:inbox-selected",
    "commandRef": "urn:command:select-inbox"
  },
  {
    "@type": "Transition",
    "@id": "urn:transition:select-drafts-from-inbox",
    "label": "Select Drafts",
    "from": "urn:state:inbox-selected",
    "to": "urn:state:drafts-selected",
    "commandRef": "urn:command:select-drafts"
  },
  {
    "@type": "Command",
    "@id": "urn:command:select-inbox",
    "label": "Select Inbox"
  },
  {
    "@type": "MessageMeta",
    "@id": "urn:message-meta:inbox",
    "defaultLocaleRef": "urn:locale:en"
  },
  {
    "@type": "Message",
    "@id": "urn:message:inbox:en",
    "messageMetaRef": "urn:message-meta:inbox",
    "localeRef": "urn:locale:en",
    "value": "Inbox"
  },
  {
    "@type": "AccessibleLocator",
    "@id": "urn:locator:inbox-tab",
    "role": "tab",
    "accessibleNameRef": "urn:message-meta:inbox",
    "contextLocatorRefs": ["urn:locator:mail-tablist"]
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:select-inbox:keyboard",
    "materializationTransitionRef": "urn:transition:select-inbox",
    "materializationModalityRef": "observability:keyboard",
    "materializationStepRefs": [
      "urn:step:select-inbox:keyboard:1",
      "urn:step:select-inbox:keyboard:2",
      "urn:step:select-inbox:keyboard:3"
    ]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-inbox:keyboard:1",
    "stepMoveKindRef": "operability:nextStop"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-inbox:keyboard:2",
    "stepPreviousRef": "urn:step:select-inbox:keyboard:1",
    "stepMoveKindRef": "operability:nextStop",
    "stepLocatorRef": "urn:locator:home-tab"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-inbox:keyboard:3",
    "stepPreviousRef": "urn:step:select-inbox:keyboard:2",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:locator:inbox-tab"
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:select-drafts-from-inbox:keyboard",
    "materializationTransitionRef": "urn:transition:select-drafts-from-inbox",
    "materializationModalityRef": "observability:keyboard",
    "materializationStartLocatorRef": "urn:locator:inbox-tab",
    "materializationStepRefs": ["urn:step:select-drafts-from-inbox:keyboard:1"]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:select-drafts-from-inbox:keyboard:1",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:locator:drafts-tab"
  }
]

9.3. Carousel Example

A carousel shows one slide at a time, and a tab list lets the user pick a slide. Each slide is a member of a StateCollection, and a member AdjacentTransition connects neighboring slides. By keyboard, the user moves focus onto the slide tab list and then to the next or previous tab, which shows the neighboring slide. The adjacency gets one materialization for each direction.

json
[
  {
    "@type": "Journey",
    "@id": "urn:journey:product-gallery",
    "label": "Product gallery",
    "defaultEntryRef": "urn:entry:product-gallery",
    "entryRefs": ["urn:entry:product-gallery"],
    "stateRefs": ["urn:state:slide"]
  },
  {
    "@type": "JourneyEntry",
    "@id": "urn:entry:product-gallery",
    "stateRef": "urn:state:slide"
  },
  {
    "@type": "State",
    "@id": "urn:state:slide",
    "label": "Slide"
  },
  {
    "@type": "StateCollection",
    "@id": "urn:collection:slides",
    "label": "Slides",
    "memberStateRef": "urn:state:slide",
    "memberTransitionRefs": ["urn:adjacent:slide-neighbors"]
  },
  {
    "@type": "AdjacentTransition",
    "@id": "urn:adjacent:slide-neighbors",
    "from": "urn:state:slide",
    "to": "urn:state:slide"
  },
  {
    "@type": "AccessibleLocator",
    "@id": "urn:locator:slide-tablist",
    "role": "tablist"
  },
  {
    "@type": "AccessibleLocator",
    "@id": "urn:locator:slide-tab",
    "role": "tab",
    "contextLocatorRefs": ["urn:locator:slide-tablist"]
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:next-slide:keyboard",
    "materializationTransitionRef": "urn:adjacent:slide-neighbors",
    "materializationDirectionRef": "operability:forward",
    "materializationModalityRef": "observability:keyboard",
    "materializationStepRefs": [
      "urn:step:next-slide:keyboard:1",
      "urn:step:next-slide:keyboard:2"
    ]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:next-slide:keyboard:1",
    "stepMoveKindRef": "operability:nextStop",
    "stepLocatorRef": "urn:locator:slide-tab"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:next-slide:keyboard:2",
    "stepPreviousRef": "urn:step:next-slide:keyboard:1",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:locator:slide-tab"
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:previous-slide:keyboard",
    "materializationTransitionRef": "urn:adjacent:slide-neighbors",
    "materializationDirectionRef": "operability:backward",
    "materializationModalityRef": "observability:keyboard",
    "materializationStepRefs": [
      "urn:step:previous-slide:keyboard:1",
      "urn:step:previous-slide:keyboard:2"
    ]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:previous-slide:keyboard:1",
    "stepMoveKindRef": "operability:nextStop",
    "stepLocatorRef": "urn:locator:slide-tab"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:previous-slide:keyboard:2",
    "stepPreviousRef": "urn:step:previous-slide:keyboard:1",
    "stepMoveKindRef": "operability:previousItem",
    "stepLocatorRef": "urn:locator:slide-tab"
  }
]
[
  {
    "@type": "Journey",
    "@id": "urn:journey:product-gallery",
    "label": "Product gallery",
    "defaultEntryRef": "urn:entry:product-gallery",
    "entryRefs": ["urn:entry:product-gallery"],
    "stateRefs": ["urn:state:slide"]
  },
  {
    "@type": "JourneyEntry",
    "@id": "urn:entry:product-gallery",
    "stateRef": "urn:state:slide"
  },
  {
    "@type": "State",
    "@id": "urn:state:slide",
    "label": "Slide"
  },
  {
    "@type": "StateCollection",
    "@id": "urn:collection:slides",
    "label": "Slides",
    "memberStateRef": "urn:state:slide",
    "memberTransitionRefs": ["urn:adjacent:slide-neighbors"]
  },
  {
    "@type": "AdjacentTransition",
    "@id": "urn:adjacent:slide-neighbors",
    "from": "urn:state:slide",
    "to": "urn:state:slide"
  },
  {
    "@type": "AccessibleLocator",
    "@id": "urn:locator:slide-tablist",
    "role": "tablist"
  },
  {
    "@type": "AccessibleLocator",
    "@id": "urn:locator:slide-tab",
    "role": "tab",
    "contextLocatorRefs": ["urn:locator:slide-tablist"]
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:next-slide:keyboard",
    "materializationTransitionRef": "urn:adjacent:slide-neighbors",
    "materializationDirectionRef": "operability:forward",
    "materializationModalityRef": "observability:keyboard",
    "materializationStepRefs": [
      "urn:step:next-slide:keyboard:1",
      "urn:step:next-slide:keyboard:2"
    ]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:next-slide:keyboard:1",
    "stepMoveKindRef": "operability:nextStop",
    "stepLocatorRef": "urn:locator:slide-tab"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:next-slide:keyboard:2",
    "stepPreviousRef": "urn:step:next-slide:keyboard:1",
    "stepMoveKindRef": "operability:nextItem",
    "stepLocatorRef": "urn:locator:slide-tab"
  },
  {
    "@type": "TransitionMaterialization",
    "@id": "urn:materialization:previous-slide:keyboard",
    "materializationTransitionRef": "urn:adjacent:slide-neighbors",
    "materializationDirectionRef": "operability:backward",
    "materializationModalityRef": "observability:keyboard",
    "materializationStepRefs": [
      "urn:step:previous-slide:keyboard:1",
      "urn:step:previous-slide:keyboard:2"
    ]
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:previous-slide:keyboard:1",
    "stepMoveKindRef": "operability:nextStop",
    "stepLocatorRef": "urn:locator:slide-tab"
  },
  {
    "@type": "MoveStep",
    "@id": "urn:step:previous-slide:keyboard:2",
    "stepPreviousRef": "urn:step:previous-slide:keyboard:1",
    "stepMoveKindRef": "operability:previousItem",
    "stepLocatorRef": "urn:locator:slide-tab"
  }
]

One pair of materializations serves every slide. The slide tab locator names any tab in the slide tab list, and which tab the user reaches is known only when the step happens.

A pointer materialization of the same adjacency would point at a slide tab with operability:pointAt. The slide tab locator matches every tab, so a runner could not choose one, and such a materialization documents the interaction without being performable. A pointer user can also swipe: a pointer materialization with one MoveStep using operability:nextPage is performable.

Copyright © 2026 the Contributors to the ujg/modules/operability, published by the User Journey Graph Community Group under the W3C Community Contributor License Agreement (CLA) . A human-readable summary is available.

GitHub Matrix room

generated by Speculator