---
title: "WorkspaceCompositionReferences · types"
url: https://developers.dagio.ai/fr/reference/types-workspace-composition-references/
---

# WorkspaceCompositionReferences · types

   
                                               
                                                                                        
                                                        
                  
           
          
   

Les types ci-dessous définissent les objets nommés et leurs relations. Les propriétés héritées sont incluses dans les tableaux. Les types dérivés d’un schéma renvoient à sa structure; une déclaration TypeScript ne remplace pas les contrôles sémantiques du compilateur.

## WorkspaceCompositionReferenceScreen

Current POC screen facts come only from admitted native Model declarations, never instance authority.

```typescript
export type WorkspaceCompositionReferenceScreen =
  | { readonly kind: 'home'; readonly references: SurfaceCompositionModelReferences }
  | { readonly kind: 'collection'; readonly destinationKey: string; readonly viewKey: string; readonly references: SurfaceCompositionModelReferences }
  | { readonly kind: 'record'; readonly recordProfileKey: string; readonly references: SurfaceCompositionModelReferences }
  | { readonly kind: 'work'; readonly experienceKey: string; readonly references: SurfaceCompositionModelReferences };
```

```typescript
type WorkspaceCompositionReferenceScreen = { readonly kind: "home"; readonly references: SurfaceCompositionModelReferences; } | { readonly kind: "collection"; readonly destinationKey: string; readonly viewKey: string; readonly references: SurfaceCompositionModelReferences; } | { readonly kind: "record"; readonly recordProfileKey: string; readonly references: SurfaceCompositionModelReferences; } | { readonly kind: "work"; readonly experienceKey: string; readonly references: SurfaceCompositionModelReferences; };
```

## WorkspaceCompositionReferences

One passive current envelope; every screen explicitly carries its actual Work capabilities, including an empty set.

| Champ | Options / valeurs attendues | Description |
| --- | --- | --- |
| `contract` | `"WorkspaceCompositionReferences@1"` | **Requis.** Discriminant exact de cette variante du contrat. Respecter la valeur littérale indiquée. |
| `catalogue` | `{ contract: "SurfaceCompositionCatalogue@1"; version: "0.0.0.1"; hash: string; }` | **Requis.** Définit « catalogue » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options. |
| `screens` | `readonly WorkspaceCompositionReferenceScreen[]` | **Requis.** Définit « screens » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options. |

```typescript
export interface WorkspaceCompositionReferences {
  readonly contract: 'WorkspaceCompositionReferences@1';
  readonly catalogue: SurfaceCompositionCatalogueIdentity;
  readonly screens: readonly WorkspaceCompositionReferenceScreen[];
}
```

[Toutes les références](https://developers.dagio.ai/fr/reference/)

<!-- surface-examples:start -->

## Exemples appliqués : Composer la fiche et ses relations

Deux Stack déclarés portent le contenu principal puis les relations, sans cadres supplémentaires. Le preset choisit la largeur du panneau droit.

### Configuration

Propriétés du composant `RecordLayout.props`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/surface-components/#recordlayout).

```json
{
  "asideWidth": "standard"
}
```

### Variante et raccordement

Propriétés du composant `RecordLayout.props`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/surface-components/#recordlayout).

```json
{
  "asideWidth": "compact"
}
```

### Exemple de disposition UI

La disposition illustrative ci-dessous situe cette configuration dans l’app Clients/Soumissions. Chaque fragment s’insère à l’emplacement indiqué; ses références aux Fields, Queries et Actions correspondent aux déclarations du Model.

1. Identité du client
2. Notes et suivi
3. Paramètres
4. Soumissions liées

<!-- surface-examples:end -->