---
alias: "fc.list.wrapper.source"
aliases:
  - fc.list.wrapper.source
category: wrapper
module: Core
---
# fc.list.wrapper.source

List wrapper that converts Metrics API data into a format readable by the `fc.list` component, used for Sources Dashboard displays.

## When to Use
- Displaying inventory source metrics in a tabular list
- Any page that needs to render Metrics API data in an `fc.list` table
- Sources Dashboard in the Big Inventory web app

## Key Props
| Prop | Type | Required | What it controls |
|------|------|----------|------------------|

No component-specific configuration properties. Uses standard `dataSource` and `descendants` configuration.

## Data Binding
Transforms Metrics API response data into the row/column format expected by `fc.list`. The page-level `data.query` should point to a Metrics API endpoint. This wrapper handles the data shape conversion automatically.

## Descendants
Yes -- accepts `fc.list` (or other list-compatible components) as children. The wrapper feeds transformed data into its descendants.

## Composition Patterns
- `fc.page` > `fc.list.wrapper.source` > `fc.list` for a sources metrics table
- Often paired with `fc.chart.bar.wrapper.source` on the same dashboard page
- Combine with `fc.daterange.wrapper.forwarder` for time-filtered source data

## Gotchas
- Only transforms Metrics API data -- will not work with standard GraphQL entity queries
- Must wrap an `fc.list` descendant to be useful -- the wrapper itself renders nothing visible
- Designed specifically for the Sources Dashboard use case in Fluent Big Inventory

## Manifest Example
```json
{
  "component": "fc.list.wrapper.source",
  "descendants": [
    {
      "component": "fc.list",
      "props": {
        "dataSource": "sourceMetrics",
        "attributes": [
          { "label": "Source", "value": "{{node.name}}" },
          { "label": "Total", "value": "{{node.total}}" },
          { "label": "Success", "value": "{{node.success}}" },
          { "label": "Failed", "value": "{{node.failed}}" }
        ]
      }
    }
  ]
}
```

## AI Parse Notes
- **Primary intent:** Declarative Mystique component definition for manifests.
- **Selection signals:** Match by `alias`, category, and required `Key Props`.
- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
- **Safety checks:** Validate required props and data bindings before manifest generation.
