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

# LayoutConcat

Defines dashboard-style concatenation for coordinated multi-view experiences.

Generated from @oods/foundry 0.10.1

- Group

  viz.layout

- Maturity

  beta

- Contexts

  none listed

## Fields it adds

| Field | Type | Required | Description |
| - | - | - | - |
| `viz_layout_type` | `string` (concat) | yes | Normalized layout identifier. |
| `viz_layout_direction` | `string` (horizontal, vertical, grid) | no | Axis used for arranging concatenated sections. |
| `viz_layout_gap` | `number` | no | Gap (px) between concatenated sections. |
| `viz_layout_shared_channels` | `string[]` | no | Channels whose domains remain shared across sections. |
| `viz_layout_max_sections` | `number` | no | Maximum section count before warning triggers. |
| `viz_layout_projection` | `string` (cartesian, polar, radial) | no | Projection metadata forwarded to adapters. |

## What it shows in each context

This trait places no component of its own.

## Parameters

- `direction` `string`

  Primary axis used to arrange concatenated sections.

- `gap` `number`

  Gap (px) between concatenated sections.

- `sharedChannels` `string[]`

  Channels propagated across concatenated children.

- `maxSections` `number`

  Maximum number of child sections governed by this layout.

- `projection` `string`

  Projection hint consumed by adapters.

## Objects that use it

No shipped object uses this trait.

## The trait file

`traits/viz/layout-concat.trait.yaml`

```
trait:
  name: LayoutConcat
  version: 0.2.0
  description: >
    Defines dashboard-style concatenation for coordinated multi-view
    experiences.
  category: viz.layout
  tags:
    - viz
    - layout
    - concat
    - dashboard

parameters:
  - name: direction
    type: string
    required: false
    description: Primary axis used to arrange concatenated sections.
    default: horizontal
    validation:
      enum: [horizontal, vertical, grid]
  - name: gap
    type: number
    required: false
    description: Gap (px) between concatenated sections.
    default: 24
    validation:
      minimum: 0
      maximum: 96
  - name: sharedChannels
    type: string[]
    required: false
    description: Channels propagated across concatenated children.
    default: [color]
  - name: maxSections
    type: number
    required: false
    description: Maximum number of child sections governed by this layout.
    default: 4
    validation:
      minimum: 2
      maximum: 12
  - name: projection
    type: string
    required: false
    description: Projection hint consumed by adapters.
    default: cartesian
    validation:
      enum: [cartesian, polar, radial]

schema:
  viz_layout_type:
    type: string
    required: true
    description: Normalized layout identifier.
    default: concat
    validation:
      enum: [concat]
  viz_layout_direction:
    type: string
    required: false
    description: Axis used for arranging concatenated sections.
    defaultFromParameter: direction
    validation:
      enum: [horizontal, vertical, grid]
  viz_layout_gap:
    type: number
    required: false
    description: Gap (px) between concatenated sections.
    defaultFromParameter: gap
    validation:
      minimum: 0
      maximum: 96
  viz_layout_shared_channels:
    type: string[]
    required: false
    description: Channels whose domains remain shared across sections.
    defaultFromParameter: sharedChannels
  viz_layout_max_sections:
    type: number
    required: false
    description: Maximum section count before warning triggers.
    defaultFromParameter: maxSections
    validation:
      minimum: 2
      maximum: 12
  viz_layout_projection:
    type: string
    required: false
    description: Projection metadata forwarded to adapters.
    defaultFromParameter: projection
    validation:
      enum: [cartesian, polar, radial]

semantics:
  viz_layout_type:
    semantic_type: viz.layout.type
    ui_hints:
      component: Badge
  viz_layout_direction:
    semantic_type: viz.layout.concat.direction
    ui_hints:
      component: Badge
  viz_layout_gap:
    semantic_type: viz.layout.spacing
    ui_hints:
      component: NumericPreview
      unit: px
  viz_layout_shared_channels:
    semantic_type: viz.layout.shared_channels
    ui_hints:
      component: ListSummary
  viz_layout_max_sections:
    semantic_type: viz.layout.concat.sections
    ui_hints:
      component: NumericPreview
  viz_layout_projection:
    semantic_type: viz.layout.projection
    ui_hints:
      component: Badge

tokens:
  viz.layout.concat.gap: var(--cmp-viz-layout-gap)

dependencies:
  - trait: MarkBar
    optional: true
  - trait: MarkLine
    optional: true
  - trait: MarkPoint
    optional: true
  - trait: MarkArea
    optional: true

metadata:
  created: '2025-11-16'
  updated: '2026-02-28'
  owners:
    - viz@oods.systems
  maturity: beta
  accessibility:
    keyboard: Concatenated sections are keyboard-navigable as a section group. Tab moves between sections.
    screenreader: Announces section count and shared channels (e.g., "Dashboard with 3 sections, shared color scale").
  examples:
    - RevenueDashboard
    - SupportMetricsOverview
    - SalesFunnelWithBreakdown
  references:
    - objects/provenance.v1.json#/references/ref-c52ae10b7f25
```