[Traits](https://oods-foundry.com/traits) / MarkGraph

# MarkGraph

Read-only force graph over a declared neighborhood edge array, rendered by public viz.render.

Generated from @oods/foundry 0.10.1

- Group

  viz.mark

- Maturity

  alpha

- Contexts

  detail

## Fields it adds

| Field | Type | Required | Description |
| - | - | - | - |
| `viz_mark_type` | `string` (graph) | yes | Normalized graph mark identifier. |

## What it shows in each context

- [detail](https://oods-foundry.com/contexts/detail)

  `VizGraphPreview`

## Parameters

- `chart` `object`

  Declared edge-array chart source for the host object's neighborhood.

- `title` `string`

  Title for the chart and its accessible figure.

- `description` `string`

  Accessible description including the provenance of example edges.

- `previewSvg` `string`

  Static SVG returned by public viz.render.

## Objects that use it

- [Relationship](https://oods-foundry.com/objects/relationship)

## The trait file

`traits/viz/mark-graph.trait.yaml`

```
trait:
  name: MarkGraph
  version: 0.1.0
  description: Read-only force graph over a declared neighborhood edge array, rendered by public viz.render.
  category: viz.mark
  tags: [viz, mark, graph, relationship]
parameters:
  - { name: chart, type: object, required: false, description: Declared edge-array chart source for the host object's neighborhood. }
  - { name: title, type: string, required: false, description: Title for the chart and its accessible figure. }
  - { name: description, type: string, required: false, description: Accessible description including the provenance of example edges. }
  - { name: previewSvg, type: string, required: false, description: Static SVG returned by public viz.render. }
schema:
  viz_mark_type:
    type: string
    required: true
    default: graph
    description: Normalized graph mark identifier.
    validation:
      enum: [graph]
view_extensions:
  detail:
    - component: VizGraphPreview
      position: top
      priority: 60
      props:
        svgParameter: previewSvg
metadata:
  created: "2026-09-14"
  updated: "2026-09-14"
  owners: [viz@oods.systems]
  maturity: alpha
  regionsUsed: [detail]
  accessibility:
    notes: The wrapper names the static graph; node identifiers and the description remain available without color or interaction.
```