Class: SceneProperties¶

Properties class for a Scene child Feature. A Scene is a single captured moment in a Storyboard — viewport, timestamp, and per-feature visibility.

URI: debrief:class/SceneProperties

 classDiagram
    class SceneProperties
    click SceneProperties href "../../classes/SceneProperties/"
      BaseFeatureProperties <|-- SceneProperties
        click BaseFeatureProperties href "../../classes/BaseFeatureProperties/"

      SceneProperties : _polygon_source





        SceneProperties --> "0..1" PolygonSourceEnum : _polygon_source
        click PolygonSourceEnum href "../../enums/PolygonSourceEnum/"



      SceneProperties : creation_order

      SceneProperties : description

      SceneProperties : display_mode





        SceneProperties --> "0..1" DisplayModeEnum : display_mode
        click DisplayModeEnum href "../../enums/DisplayModeEnum/"



      SceneProperties : feature_set_hash

      SceneProperties : id

      SceneProperties : kind





        SceneProperties --> "1" FeatureKindEnum : kind
        click FeatureKindEnum href "../../enums/FeatureKindEnum/"



      SceneProperties : provenance





        SceneProperties --> "*" LogEntry : provenance
        click LogEntry href "../../classes/LogEntry/"



      SceneProperties : storyboard_id

      SceneProperties : tags

      SceneProperties : thumbnail_asset_ref

      SceneProperties : time_range





        SceneProperties --> "0..1" TimeRange : time_range
        click TimeRange href "../../classes/TimeRange/"



      SceneProperties : timestamp

      SceneProperties : title

      SceneProperties : transition_duration_ms

      SceneProperties : vertex_metadata





        SceneProperties --> "*" VertexMetadata : vertex_metadata
        click VertexMetadata href "../../classes/VertexMetadata/"



      SceneProperties : viewport





        SceneProperties --> "1" Viewport : viewport
        click Viewport href "../../classes/Viewport/"



      SceneProperties : viewport_end





        SceneProperties --> "0..1" Viewport : viewport_end
        click Viewport href "../../classes/Viewport/"



      SceneProperties : visible

      SceneProperties : visible_feature_ids

Inheritance¶

BaseFeatureProperties
- SceneProperties

Slots¶

Name	Cardinality and Range	Description	Inheritance
kind	1 FeatureKindEnum	Feature kind discriminator (pinned to STORYBOARD_SCENE)	direct
id	1 String	ULID (26 chars, Crockford base-32)	direct
storyboard_id	1 String	Foreign key to parent Storyboard	direct
title	1 String	Display title	direct
description	0..1 String	Markdown per-scene narrative	direct
viewport	1 Viewport	Map viewport camera state at capture time	direct
timestamp	1 datetime	ISO-8601 instant when the Scene was captured	direct
creation_order	1 Integer	Per-Storyboard monotonic sequence value assigned by the platform at capture t...	direct
time_range	0..1 TimeRange	For instant Scenes (#215 default): MUST be absent	direct
viewport_end	0..1 Viewport	Map viewport camera state at the end of a time-range Scene (#263)	direct
visible_feature_ids	1..* String	Stable feature IDs visible at capture	direct
feature_set_hash	1 String	SHA-256 hex (lowercase, 64 chars) of JSON	direct
thumbnail_asset_ref	1 String	STAC asset key (path + name within the plot's STAC item)	direct
transition_duration_ms	1 Integer	Playback transition duration in milliseconds	direct
display_mode	0..1 DisplayModeEnum	Time-controller display mode at capture time (full = entire track history; tr...	direct
_polygon_source	0..1 PolygonSourceEnum	Provenance of the scene's stored polygon geometry (Spec #258)	direct
tags	* String	Free-text labels assigned to this feature by the analyst	BaseFeatureProperties
visible	0..1 Boolean	Whether this feature is shown on the map	BaseFeatureProperties
provenance	* LogEntry	PROV-aligned provenance records (append-only log of tool operations)	BaseFeatureProperties
vertex_metadata	* VertexMetadata	Sparse list of per-vertex metadata, keyed by `path`	BaseFeatureProperties

Usages¶

used by	used in	type	used
SceneFeature	properties	range	SceneProperties

Rules¶

¶

| Rule Applied | Preconditions | Postconditions | Elseconditions | |--------------|---------------|----------------|----------------|| slot_conditions |{'time_range': {'value_presence': 'PRESENT'}} |{'viewport_end': {'value_presence': 'PRESENT'}} | |

¶

| Rule Applied | Preconditions | Postconditions | Elseconditions | |--------------|---------------|----------------|----------------|| slot_conditions |{'viewport_end': {'value_presence': 'PRESENT'}} |{'time_range': {'value_presence': 'PRESENT'}} | |

Identifier and Mapping Information¶

Schema Source¶

from schema: https://debrief.info/schemas/debrief

Mappings¶

Mapping Type	Mapped Value
self	debrief:SceneProperties
native	debrief:SceneProperties

LinkML Source¶

Direct¶

name: SceneProperties
description: Properties class for a Scene child Feature. A Scene is a single captured
  moment in a Storyboard — viewport, timestamp, and per-feature visibility.
from_schema: https://debrief.info/schemas/debrief
is_a: BaseFeatureProperties
attributes:
  kind:
    name: kind
    description: Feature kind discriminator (pinned to STORYBOARD_SCENE)
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - BaseFeatureProperties
    - TrackProperties
    - ReferenceLocationProperties
    - SystemStateProperties
    - MultiPointFeatureProperties
    - MultiPolygonFeatureProperties
    - NarrativeEntryProperties
    - CircleAnnotationProperties
    - RectangleAnnotationProperties
    - LineAnnotationProperties
    - TextAnnotationProperties
    - VectorAnnotationProperties
    - PolyAnnotationProperties
    - SelectionRequirement
    - SystemRecordProperties
    - StoryboardProperties
    - SceneProperties
    - MCPSelectionRequirement
    range: FeatureKindEnum
    required: true
    equals_string: STORYBOARD_SCENE
  id:
    name: id
    description: ULID (26 chars, Crockford base-32). Immutable after create.
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - TrackFeature
    - ReferenceLocation
    - SystemState
    - MultiPointFeature
    - MultiPolygonFeature
    - NarrativeEntry
    - CircleAnnotation
    - RectangleAnnotation
    - LineAnnotation
    - TextAnnotation
    - VectorAnnotation
    - PolyAnnotation
    - Tool
    - PlatformRecord
    - PlotSummary
    - StacItemSummary
    - StacItem
    - StacCatalog
    - StacCollection
    - RawGeoJSONFeature
    - StoryboardProperties
    - SceneProperties
    - StoryboardFeature
    - SceneFeature
    - ToolDefinition
    range: string
    required: true
    pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
  storyboard_id:
    name: storyboard_id
    description: Foreign key to parent Storyboard.properties.id (ULID).
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: string
    required: true
    pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
  title:
    name: title
    description: Display title. Defaults to DTG of timestamp in DDHHmmZ MMM YY; falls
      back to ISO-8601 on parse failure.
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - PlotSummary
    - StacItemSummary
    - StacItemProperties
    - StacCatalog
    - StacLink
    - StacAsset
    - StacItemAssetDefinition
    - StacCollection
    - DatasetEntry
    - SceneProperties
    - SceneThumbnailAssetEntry
    range: string
    required: true
  description:
    name: description
    description: Markdown per-scene narrative
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - ReferenceLocationProperties
    - MultiPointFeatureProperties
    - MultiPolygonFeatureProperties
    - Tool
    - ToolParameter
    - StacProvider
    - StacItemProperties
    - StacCatalog
    - StacAsset
    - StacItemAssetDefinition
    - StacCollection
    - LevelDefinition
    - StoryboardProperties
    - SceneProperties
    - MCPParamSchema
    - MCPToolDefinition
    - ToolDefinition
    range: string
    required: false
  viewport:
    name: viewport
    description: Map viewport camera state at capture time
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - SystemStateProperties
    - SpatialSlice
    - SceneProperties
    range: Viewport
    required: true
  timestamp:
    name: timestamp
    description: 'ISO-8601 instant when the Scene was captured. Drives Scene ordering
      (ascending within a Storyboard) as the primary sort key. Multiple Scenes MAY
      share the same timestamp; ties are broken by `creation_order` ascending (see
      #259).'
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - LogEntry
    - TuneAnnotation
    - FileProvEntry
    - PropertiesProvenanceEntry
    - FeatureSelection
    - SceneProperties
    range: datetime
    required: true
  creation_order:
    name: creation_order
    description: 'Per-Storyboard monotonic sequence value assigned by the platform
      at capture time. Acts as the secondary sort key for Scenes — when two Scenes
      share a `timestamp` the one with the lower `creation_order` comes first. Unique
      within a Storyboard; gaps are permitted (left by deletion). The platform — not
      the client — is the source of truth. Introduced by #259; absent on pre-#259
      plots which are rejected at load (no migration shim — Article XIV pre-release
      freedom).'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: integer
    required: true
    minimum_value: 0
  time_range:
    name: time_range
    description: 'For instant Scenes (#215 default): MUST be absent. For time-range
      Scenes (#263): a TimeRange sub-record. When present, the Scene is the time-range
      flavour and `viewport_end` MUST also be present. See cross-field rule `scene-flavour-xor-rule`.'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: TimeRange
    required: false
  viewport_end:
    name: viewport_end
    description: Map viewport camera state at the end of a time-range Scene (#263).
      MUST be present if and only if `time_range` is present. Reuses the Viewport
      sub-record (`bearing` MUST be 0). For instant Scenes this slot MUST be absent.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: Viewport
    required: false
  visible_feature_ids:
    name: visible_feature_ids
    description: Stable feature IDs visible at capture. Canonicalised (trim, reject
      empty, dedupe, sort lexicographically) by the CRUD module before hashing. Order-insensitive
      from the consumer's perspective.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: string
    required: true
    multivalued: true
  feature_set_hash:
    name: feature_set_hash
    description: SHA-256 hex (lowercase, 64 chars) of JSON.stringify(canonical visible_feature_ids).
      Recomputed on every create/update touching visible_feature_ids.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: string
    required: true
    pattern: ^[0-9a-f]{64}$
  thumbnail_asset_ref:
    name: thumbnail_asset_ref
    description: 'STAC asset key (path + name within the plot''s STAC item). Populated
      by #216 at capture time via #174 helpers.'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: string
    required: true
  transition_duration_ms:
    name: transition_duration_ms
    description: Playback transition duration in milliseconds. Default 500.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: integer
    required: true
    minimum_value: 0
  display_mode:
    name: display_mode
    description: 'Time-controller display mode at capture time (full = entire track
      history; trail = only the tail behind each platform). Reuses DisplayModeEnum
      from session-state.yaml. Optional for legacy compatibility (Spec #258): readers
      MUST leave the time controller untouched when this slot is absent (FR-003).
      Writers populate it from session.displayMode at the moment the scene is created.'
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - SystemStateProperties
    - SceneProperties
    range: DisplayModeEnum
    required: false
  _polygon_source:
    name: _polygon_source
    description: 'Provenance of the scene''s stored polygon geometry (Spec #258).
      ''bounds'' = computed from real Leaflet map bounds at capture time; ''placeholder''
      = pre-#258 ~100m square; ''manual'' = reserved for future user-drawn rectangles.
      Render-side consumers recompute the polygon from (viewport, map dimensions)
      when this value is anything other than ''bounds'' (including absent, for legacy
      scenes). The stored geometry is NEVER rewritten on read (Article III.2 source
      preservation).'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneProperties
    range: PolygonSourceEnum
    required: false
rules:
- preconditions:
    slot_conditions:
      time_range:
        name: time_range
        value_presence: PRESENT
  postconditions:
    slot_conditions:
      viewport_end:
        name: viewport_end
        value_presence: PRESENT
  description: 'Scene flavour XOR (#263): a Scene is either the instant flavour (both
    `time_range` and `viewport_end` absent) or the time-range flavour (both present).
    Any other combination is rejected with `SceneFlavourXorViolation`.'
- preconditions:
    slot_conditions:
      viewport_end:
        name: viewport_end
        value_presence: PRESENT
  postconditions:
    slot_conditions:
      time_range:
        name: time_range
        value_presence: PRESENT
  description: 'Scene flavour XOR (#263, reverse): if `viewport_end` is present then
    `time_range` MUST also be present.'

Induced¶

name: SceneProperties
description: Properties class for a Scene child Feature. A Scene is a single captured
  moment in a Storyboard — viewport, timestamp, and per-feature visibility.
from_schema: https://debrief.info/schemas/debrief
is_a: BaseFeatureProperties
attributes:
  kind:
    name: kind
    description: Feature kind discriminator (pinned to STORYBOARD_SCENE)
    from_schema: https://debrief.info/schemas/storyboard
    alias: kind
    owner: SceneProperties
    domain_of:
    - BaseFeatureProperties
    - TrackProperties
    - ReferenceLocationProperties
    - SystemStateProperties
    - MultiPointFeatureProperties
    - MultiPolygonFeatureProperties
    - NarrativeEntryProperties
    - CircleAnnotationProperties
    - RectangleAnnotationProperties
    - LineAnnotationProperties
    - TextAnnotationProperties
    - VectorAnnotationProperties
    - PolyAnnotationProperties
    - SelectionRequirement
    - SystemRecordProperties
    - StoryboardProperties
    - SceneProperties
    - MCPSelectionRequirement
    range: FeatureKindEnum
    required: true
    equals_string: STORYBOARD_SCENE
  id:
    name: id
    description: ULID (26 chars, Crockford base-32). Immutable after create.
    from_schema: https://debrief.info/schemas/storyboard
    alias: id
    owner: SceneProperties
    domain_of:
    - TrackFeature
    - ReferenceLocation
    - SystemState
    - MultiPointFeature
    - MultiPolygonFeature
    - NarrativeEntry
    - CircleAnnotation
    - RectangleAnnotation
    - LineAnnotation
    - TextAnnotation
    - VectorAnnotation
    - PolyAnnotation
    - Tool
    - PlatformRecord
    - PlotSummary
    - StacItemSummary
    - StacItem
    - StacCatalog
    - StacCollection
    - RawGeoJSONFeature
    - StoryboardProperties
    - SceneProperties
    - StoryboardFeature
    - SceneFeature
    - ToolDefinition
    range: string
    required: true
    pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
  storyboard_id:
    name: storyboard_id
    description: Foreign key to parent Storyboard.properties.id (ULID).
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: storyboard_id
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: string
    required: true
    pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
  title:
    name: title
    description: Display title. Defaults to DTG of timestamp in DDHHmmZ MMM YY; falls
      back to ISO-8601 on parse failure.
    from_schema: https://debrief.info/schemas/storyboard
    alias: title
    owner: SceneProperties
    domain_of:
    - PlotSummary
    - StacItemSummary
    - StacItemProperties
    - StacCatalog
    - StacLink
    - StacAsset
    - StacItemAssetDefinition
    - StacCollection
    - DatasetEntry
    - SceneProperties
    - SceneThumbnailAssetEntry
    range: string
    required: true
  description:
    name: description
    description: Markdown per-scene narrative
    from_schema: https://debrief.info/schemas/storyboard
    alias: description
    owner: SceneProperties
    domain_of:
    - ReferenceLocationProperties
    - MultiPointFeatureProperties
    - MultiPolygonFeatureProperties
    - Tool
    - ToolParameter
    - StacProvider
    - StacItemProperties
    - StacCatalog
    - StacAsset
    - StacItemAssetDefinition
    - StacCollection
    - LevelDefinition
    - StoryboardProperties
    - SceneProperties
    - MCPParamSchema
    - MCPToolDefinition
    - ToolDefinition
    range: string
    required: false
  viewport:
    name: viewport
    description: Map viewport camera state at capture time
    from_schema: https://debrief.info/schemas/storyboard
    alias: viewport
    owner: SceneProperties
    domain_of:
    - SystemStateProperties
    - SpatialSlice
    - SceneProperties
    range: Viewport
    required: true
  timestamp:
    name: timestamp
    description: 'ISO-8601 instant when the Scene was captured. Drives Scene ordering
      (ascending within a Storyboard) as the primary sort key. Multiple Scenes MAY
      share the same timestamp; ties are broken by `creation_order` ascending (see
      #259).'
    from_schema: https://debrief.info/schemas/storyboard
    alias: timestamp
    owner: SceneProperties
    domain_of:
    - LogEntry
    - TuneAnnotation
    - FileProvEntry
    - PropertiesProvenanceEntry
    - FeatureSelection
    - SceneProperties
    range: datetime
    required: true
  creation_order:
    name: creation_order
    description: 'Per-Storyboard monotonic sequence value assigned by the platform
      at capture time. Acts as the secondary sort key for Scenes — when two Scenes
      share a `timestamp` the one with the lower `creation_order` comes first. Unique
      within a Storyboard; gaps are permitted (left by deletion). The platform — not
      the client — is the source of truth. Introduced by #259; absent on pre-#259
      plots which are rejected at load (no migration shim — Article XIV pre-release
      freedom).'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: creation_order
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: integer
    required: true
    minimum_value: 0
  time_range:
    name: time_range
    description: 'For instant Scenes (#215 default): MUST be absent. For time-range
      Scenes (#263): a TimeRange sub-record. When present, the Scene is the time-range
      flavour and `viewport_end` MUST also be present. See cross-field rule `scene-flavour-xor-rule`.'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: time_range
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: TimeRange
    required: false
  viewport_end:
    name: viewport_end
    description: Map viewport camera state at the end of a time-range Scene (#263).
      MUST be present if and only if `time_range` is present. Reuses the Viewport
      sub-record (`bearing` MUST be 0). For instant Scenes this slot MUST be absent.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: viewport_end
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: Viewport
    required: false
  visible_feature_ids:
    name: visible_feature_ids
    description: Stable feature IDs visible at capture. Canonicalised (trim, reject
      empty, dedupe, sort lexicographically) by the CRUD module before hashing. Order-insensitive
      from the consumer's perspective.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: visible_feature_ids
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: string
    required: true
    multivalued: true
  feature_set_hash:
    name: feature_set_hash
    description: SHA-256 hex (lowercase, 64 chars) of JSON.stringify(canonical visible_feature_ids).
      Recomputed on every create/update touching visible_feature_ids.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: feature_set_hash
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: string
    required: true
    pattern: ^[0-9a-f]{64}$
  thumbnail_asset_ref:
    name: thumbnail_asset_ref
    description: 'STAC asset key (path + name within the plot''s STAC item). Populated
      by #216 at capture time via #174 helpers.'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: thumbnail_asset_ref
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: string
    required: true
  transition_duration_ms:
    name: transition_duration_ms
    description: Playback transition duration in milliseconds. Default 500.
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: transition_duration_ms
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: integer
    required: true
    minimum_value: 0
  display_mode:
    name: display_mode
    description: 'Time-controller display mode at capture time (full = entire track
      history; trail = only the tail behind each platform). Reuses DisplayModeEnum
      from session-state.yaml. Optional for legacy compatibility (Spec #258): readers
      MUST leave the time controller untouched when this slot is absent (FR-003).
      Writers populate it from session.displayMode at the moment the scene is created.'
    from_schema: https://debrief.info/schemas/storyboard
    alias: display_mode
    owner: SceneProperties
    domain_of:
    - SystemStateProperties
    - SceneProperties
    range: DisplayModeEnum
    required: false
  _polygon_source:
    name: _polygon_source
    description: 'Provenance of the scene''s stored polygon geometry (Spec #258).
      ''bounds'' = computed from real Leaflet map bounds at capture time; ''placeholder''
      = pre-#258 ~100m square; ''manual'' = reserved for future user-drawn rectangles.
      Render-side consumers recompute the polygon from (viewport, map dimensions)
      when this value is anything other than ''bounds'' (including absent, for legacy
      scenes). The stored geometry is NEVER rewritten on read (Article III.2 source
      preservation).'
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: _polygon_source
    owner: SceneProperties
    domain_of:
    - SceneProperties
    range: PolygonSourceEnum
    required: false
  tags:
    name: tags
    description: Free-text labels assigned to this feature by the analyst
    from_schema: https://debrief.info/schemas/common
    rank: 1000
    alias: tags
    owner: SceneProperties
    domain_of:
    - BaseFeatureProperties
    - VertexMetadata
    - StacExtensionProperties
    - StacItemSummary
    range: string
    required: false
    multivalued: true
  visible:
    name: visible
    description: Whether this feature is shown on the map. Absent or true means visible;
      false means hidden. Replaces the session sidecar's hiddenFeatureIds denylist
      (feature 261). Per-feature visibility travels with the feature inside features.geojson.
    from_schema: https://debrief.info/schemas/common
    rank: 1000
    alias: visible
    owner: SceneProperties
    domain_of:
    - BaseFeatureProperties
    - SensorContact
    - SensorData
    range: boolean
    required: false
  provenance:
    name: provenance
    description: PROV-aligned provenance records (append-only log of tool operations)
    from_schema: https://debrief.info/schemas/common
    rank: 1000
    alias: provenance
    owner: SceneProperties
    domain_of:
    - BaseFeatureProperties
    - SystemStateProperties
    - SystemRecordProperties
    range: LogEntry
    multivalued: true
    inlined: true
    inlined_as_list: true
  vertex_metadata:
    name: vertex_metadata
    description: 'Sparse list of per-vertex metadata, keyed by `path`. Empty arrays
      MUST be omitted from the serialised feature (FR-010). Duplicate `path` values
      MUST be rejected by validators (contract §Cross-cutting #3). Every concrete
      subclass of `BaseFeatureProperties` gains this slot by inheritance — see spec
      #192, contracts/vertex-metadata-slot.md.'
    from_schema: https://debrief.info/schemas/common
    rank: 1000
    alias: vertex_metadata
    owner: SceneProperties
    domain_of:
    - BaseFeatureProperties
    range: VertexMetadata
    required: false
    multivalued: true
    inlined: true
    inlined_as_list: true
rules:
- preconditions:
    slot_conditions:
      time_range:
        name: time_range
        value_presence: PRESENT
  postconditions:
    slot_conditions:
      viewport_end:
        name: viewport_end
        value_presence: PRESENT
  description: 'Scene flavour XOR (#263): a Scene is either the instant flavour (both
    `time_range` and `viewport_end` absent) or the time-range flavour (both present).
    Any other combination is rejected with `SceneFlavourXorViolation`.'
- preconditions:
    slot_conditions:
      viewport_end:
        name: viewport_end
        value_presence: PRESENT
  postconditions:
    slot_conditions:
      time_range:
        name: time_range
        value_presence: PRESENT
  description: 'Scene flavour XOR (#263, reverse): if `viewport_end` is present then
    `time_range` MUST also be present.'