# Styled Columns in AdapTable

Canonical page: https://www.adaptabletools.com/docs/handbook-styled-column-overview

- AdapTable provides **8** Styled Columns which render a column with a rich, data-driven visual style:
  - Gradient Style
  - Percent Bar
  - Badge Style
  - Sparkline Column
  - Bullet Chart
  - Rating Style
  - Range Bar
  - Icon Style

Styled Columns enable users of AdapTable to visualise their data in sophisticated and powerful ways.

They are designed to enable complicated styles to be defined with just a few clicks (or property settings), while providing a very striking visual effect.

Under **Cell Rendering**, Styled Columns complement [Format Columns](https://www.adaptabletools.com/docs/handbook-column-formatting/index.md) (text and cell chrome) and [Flashing Cells](https://www.adaptabletools.com/docs/handbook-flashing-cell/index.md) (short-lived highlights). Definitions live in **`StyledColumn` state** (and the Styled Column wizard); there is no separate Adaptable Options module — see [Styled Column Technical Reference](https://www.adaptabletools.com/docs/technical-reference-styled-column/index.md).

A Styled Column can be limited to specific Layouts via [Layout Extensions](https://www.adaptabletools.com/docs/handbook-layouts-extending/index.md)

There are **8** Styled Columns provided by AdapTable:

| Styled Column                                                                | Column Type      | Description                                                   |
| ---------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------- |
| [Gradient](https://www.adaptabletools.com/docs/handbook-styled-column-gradient/index.md)       | Numeric          | Colours cells by comparing values against one or more ranges  |
| [Percent Bar](https://www.adaptabletools.com/docs/handbook-styled-column-percent-bar/index.md) | Numeric          | Draws a horizontal bar whose length reflects the value        |
| [Badge](https://www.adaptabletools.com/docs/handbook-styled-column-badge/index.md)             | Numeric, text    | Renders badge(s) in a cell, with optional icons and rules     |
| [Sparkline](https://www.adaptabletools.com/docs/handbook-styled-column-sparkline/index.md)     | Numeric array    | Renders an AG Grid sparkline in each cell from array data     |
| [Bullet Chart](https://www.adaptabletools.com/docs/handbook-styled-column-bullet/index.md)     | Numeric          | Renders a bullet graph inside a cell                          |
| [Rating](https://www.adaptabletools.com/docs/handbook-styled-column-rating/index.md)           | Numeric          | Renders a row of icons (e.g. stars) scaled to the cell value  |
| [Range Bar](https://www.adaptabletools.com/docs/handbook-styled-column-range-bar/index.md)     | Numeric          | Shows value and optional reference on track between min & max |
| [Icon](https://www.adaptabletools.com/docs/handbook-styled-column-icon/index.md)               | Any (key lookup) | Maps cell values to icons with presets and optional cell text |

## Topics in this Section

Each style type has its own handbook page (demos and configuration detail). **One column, one style** — pick a single type per `ColumnId`.

| Topic                                                                                             | Summary                                                                            |
| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [Gradient Column Style](https://www.adaptabletools.com/docs/handbook-styled-column-gradient/index.md)               | Numeric heatmap bands; ranges, zero-centred, column comparison                     |
| [Percent Bar Style](https://www.adaptabletools.com/docs/handbook-styled-column-percent-bar/index.md)                | Horizontal bar from numeric value or percentage of a range                         |
| [Badge Style](https://www.adaptabletools.com/docs/handbook-styled-column-badge/index.md)                            | Rule-driven pills with optional icons (incl. arrays and custom functions)          |
| [Sparkline Column](https://www.adaptabletools.com/docs/handbook-styled-column-sparkline/index.md)                   | AG Grid sparklines on array columns (**Charts** module; data rows only)            |
| [Bullet Chart Style](https://www.adaptabletools.com/docs/handbook-styled-column-bullet/index.md)                    | Value, target marker and qualitative bands in one cell                             |
| [Rating Column Style](https://www.adaptabletools.com/docs/handbook-styled-column-rating/index.md)                   | Icon row (e.g. stars) scaled to the cell value                                     |
| [Range Bar Style](https://www.adaptabletools.com/docs/handbook-styled-column-range-bar/index.md)                    | Track between min/max with value and optional reference marker                     |
| [Icon Column Style](https://www.adaptabletools.com/docs/handbook-styled-column-icon/index.md)                       | Key → icon mappings and built-in presets                                           |
| [Row scope](#row-scope)                                                                           | Which row kinds render (per-type defaults; sparklines exclude group/summary/total) |
| [Styled Column Technical Reference](https://www.adaptabletools.com/docs/technical-reference-styled-column/index.md) | State shapes, per-style properties, API                                            |

### How Styled Columns Work in AdapTable and how to implement them

Each time the application starts up AdapTable retrieves any Styled Column definitions from the `StyledColumn` section of [Initial Adaptable State](https://www.adaptabletools.com/docs/dev-guide-adaptable-state-initial-state/index.md) (or from persisted user state).

For each definition, AdapTable will do 2 things:

1. Create a [Adaptable Column](https://www.adaptabletools.com/docs/dev-guide-columns-adaptable-column/index.md) with the properties set based on the definition
2. Update the existing AG Grid column by attaching a bespoke [cell renderer](https://www.ag-grid.com/javascript-data-grid/component-cell-renderer/) for that style type

Cells re-render when their value changes and when other relevant data changes — for example when a range uses `Col-Min` / `Col-Avg` / `Col-Max` and peer values in the column move.

<b>Design-time and integration checklist</b>

These are the details that most often explain “why doesn't my styled column show?”:

| Topic                    | What to know                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`ColumnId`**           | Must match an AG Grid column id (usually the `field`). A typo or a column not yet in `columnDefs` means the definition is ignored.                                                                                                                                                                                                                                    |
| **One style per column** | A column has at most **one** Styled Column. Each definition sets a single style property (`GradientStyle`, `BadgeStyle`, `SparklineStyle`, etc.) — types are mutually exclusive.                                                                                                                                                                                      |
| **Data type**            | Numeric styles (`Gradient`, `Percent Bar`, `Bullet Chart`, `Range Bar`, `Rating`) require a numeric column. `Sparkline` needs a `numberArray` column and charts enabled. `Badge` and `Icon` are the most permissive.                                                                                                                                                  |
| **Row scope**            | Each type has default row kinds (data / group / summary / total). Sparklines are **data rows only**. See [Understanding the RowScope object](#row-scope) below.                                                                                                                                                                                                       |
| **Format Columns**       | The renderer-owned visuals always come from the Styled Column. Where a style exposes `Font` and/or `Cell` slices (see [Adaptable Style Object](https://www.adaptabletools.com/docs/ui-tutorial-providing-adaptable-style/index.md#slice-composition)), those override the matching Format Column properties on the same column; anything left unset still inherits from Format Columns. |
| **Suspended**            | `IsSuspended: true` keeps the definition but stops rendering — useful for A/B comparison without deleting state.                                                                                                                                                                                                                                                      |
| **Runtime check**        | `adaptableApi.styledColumnApi.getStyledColumnForColumnId(columnId)` returns what AdapTable resolved for that column (or `undefined`).                                                                                                                                                                                                                                 |
| **Dynamic range ends**   | Gradient, Percent Bar, Bullet Chart and Range Bar expose **`Col-Min`** / **`Col-Max`** in the wizard. **`Col-Avg`** and **`Col-Median`** are supported in **Initial State** and API — see [Gradient Column Style](https://www.adaptabletools.com/docs/handbook-styled-column-gradient/index.md).                                                                                        |

For Styled Column State and Styled Column API methods see [Styled Column Technical Reference](https://www.adaptabletools.com/docs/technical-reference-styled-column/index.md)

**Example: Styled Columns**

Styled Columns in AdapTable

- This demo contains one example of each of the **8** Styled Columns provided by AdapTable
  - **Language** — [Badge Style](https://www.adaptabletools.com/docs/handbook-styled-column-badge/index.md) (each distinct value has its own colour)
  - **Issue Change** — [Gradient Style](https://www.adaptabletools.com/docs/handbook-styled-column-gradient/index.md) (using a zero-centred gradient)
  - **GitHub Stars** — [Percent Bar Style](https://www.adaptabletools.com/docs/handbook-styled-column-percent-bar/index.md)
  - **History** — [Sparkline Column](https://www.adaptabletools.com/docs/handbook-styled-column-sparkline/index.md) (line)
  - **Open Issues** — [Bullet Chart Style](https://www.adaptabletools.com/docs/handbook-styled-column-bullet/index.md)
  - **Popularity** — [Rating Style](https://www.adaptabletools.com/docs/handbook-styled-column-rating/index.md)
  - **Forks** — [Range Bar Style](https://www.adaptabletools.com/docs/handbook-styled-column-range-bar/index.md)
  - **Trend** — [Icon Style](https://www.adaptabletools.com/docs/handbook-styled-column-icon/index.md) (`trend` is a [Calculated Column](https://www.adaptabletools.com/docs/handbook-calculated-column/index.md) with a `CASE` [expression](https://www.adaptabletools.com/docs/adaptable-ql-expression-advanced-logic/index.md) on `Issue Change`; uses built-in `Trend` preset)

Demo project (Vanilla); the files without a marker are shown below:

```text
src/
  adaptableOptions.ts
  agGridModules.ts     [template, with charts]
  columnDefs.ts
  gridOptions.ts       [template]
  index.ts             [template]
  onAdaptableReady.ts  [template]
  rowData.ts
  styles.css           [template]
index.html             [template]
package.json           [template] + ag-charts-enterprise
tsconfig.json          [template]
```

Files marked `[template]` are the same in every demo; see the [demo template](https://www.adaptabletools.com/llms/demo-template.md#vanilla).

**`src/adaptableOptions.ts`**

```ts
import {AdaptableOptions} from '@adaptabletools/adaptable';
import {WebFramework} from './rowData';

export const adaptableOptions: AdaptableOptions<WebFramework> = {
  primaryKey: 'id',
  adaptableId: 'Styled Columns',
  initialState: {
    Dashboard: {
      ModuleButtons: ['StyledColumn', 'CalculatedColumn'],
    },
    Theme: {CurrentTheme: 'dark'},
    Layout: {
      CurrentLayout: 'StyledColumn',
      Layouts: [
        {
          Name: 'StyledColumn',
          ColumnSorts: [
            {
              ColumnId: 'week_issue_change',
              SortOrder: 'Desc',
            },
          ],
          TableColumns: [
            'name',
            'language',
            'week_issue_change',
            'github_stars',
            'historyLine',
            'open_issues_count',
            'popularityRating',
            'forks_count',
            'trend',
          ],
          AutoSizeColumns: true,
        },
      ],
    },
    CalculatedColumn: {
      CalculatedColumns: [
        {
          ColumnId: 'trend',
          FriendlyName: 'Trend',
          Expression: "CASE WHEN [week_issue_change] > 0 THEN 'Up' WHEN [week_issue_change] < 0 THEN 'Down' ELSE 'Flat' END",
          CalculatedColumnSettings: {
            DataType: 'text',
            Resizable: true,
            Width: 120,
          },
        },
      ],
    },
    StyledColumn: {
      StyledColumns: [
        {
          ColumnId: 'language',
          Name: 'language Badge',
          BadgeStyle: {
            Badges: [
              {
                Shape: 'Rounded',
                Rule: '[language] = "JavaScript"',
                PillStyle: {
                  BackColor: '#f7df1e',
                  ForeColor: '#323330',
                },
              },
              {
                Shape: 'Rounded',
                Rule: '[language] = "TypeScript"',
                PillStyle: {
                  BackColor: '#3178c6',
                  ForeColor: 'var(--ab-color-palette-14)',
                },
              },
              {
                Shape: 'Rounded',
                Rule: '[language] = "HTML"',
                PillStyle: {
                  BackColor: '#e34c26',
                  ForeColor: 'var(--ab-color-palette-14)',
                },
              },
            ],
          },
        },
        {
          ColumnId: 'week_issue_change',
          Name: 'week_issue_change Gradient',
          GradientStyle: {
            ZeroCentred: {
              NegativeColor: '#ff0000',
              PositiveColor: '#378805',
            },
          },
        },
        {
          ColumnId: 'github_stars',
          Name: 'github_stars PercentBar',
          PercentBarStyle: {
            RangeValueType: 'Number',
            CellRanges: [
              {
                Min: 0,
                Max: 10000,
                Color: 'red',
              },
              {
                Min: 10000,
                Max: 100000,
                Color: 'orange',
              },
              {
                Min: 100000,
                Max: 200000,
                Color: 'green',
              },
            ],
            BackColor: 'var(--ab-color-palette-15)',
          },
        },
        {
          ColumnId: 'historyLine',
          Name: 'historyLine Sparkline',
          SparklineStyle: {
            options: {
              type: 'line',
              stroke: 'rgb(124, 255, 178)',
              strokeWidth: 2,
              padding: {
                top: 5,
                bottom: 5,
              },
              marker: {
                enabled: true,
                size: 3,
                shape: 'diamond',
              },
            },
          },
        },
        {
          ColumnId: 'open_issues_count',
          Name: 'open_issues_count Bullet',
          BulletChartStyle: {
            RangeValueType: 'Number',
            CellRanges: [
              {
                Min: 'Col-Min',
                Max: 'Col-Avg',
                Color: 'rgba(40, 167, 69, 0.35)',
              },
              {
                Min: 'Col-Avg',
                Max: 'Col-Max',
                Color: 'rgba(255, 193, 7, 0.35)',
              },
            ],
            TargetProperties: {
              Target: 'Col-Avg',
              Marker: {
                Shape: 'Line',
                Color: 'var(--ab-color-foreground, #e2e2e2)',
                Size: 2,
              },
            },
            Bar: {Color: '#07c', Height: 8},
          },
        },
        {
          ColumnId: 'popularityRating',
          Name: 'popularityRating Rating',
          RatingStyle: {
            Icon: 'Star',
            Max: 5,
            Size: 16,
            Gap: 2,
            AllowHalf: true,
            ShowValue: true,
            ToolTipText: ['CellValue', 'PercentageValue'],
          },
        },
        {
          ColumnId: 'forks_count',
          Name: 'forks_count RangeBar',
          RangeBarStyle: {
            Min: 0,
            Max: 50000,
            Reference: {
              Value: 'github_watchers',
              Marker: {
                Shape: 'Line',
                Color: 'var(--ab-color-foreground, #e2e2e2)',
                Size: 2,
              },
            },
            Marker: {
              Shape: 'Diamond',
              Color: 'var(--ab-color-accent, #07c)',
              Size: 8,
            },
            Track: {Color: 'rgba(255, 255, 255, 0.35)', Height: 4},
            CellTextProperties: {
              CellTextLayout: {
                CellValue: {Horizontal: 'Left', Vertical: 'Below'},
              },
            },
            OutOfRange: {Mode: 'Overflow', Color: '#ff6b6b'},
          },
        },
        {
          ColumnId: 'trend',
          Name: 'trend Icon',
          IconStyle: {
            Preset: 'Trend',
            CellTextProperties: {
              CellText: ['IconDescription'],
              CellTextPosition: 'After',
            },
            ToolTipText: ['CellValue'],
            Size: 22,
            Gap: 6,
          },
        },
      ],
    },
  },
};
```

**`src/columnDefs.ts`**

```ts
import {ColDef} from 'ag-grid-enterprise';

export const columnDefs: ColDef[] = [
  {
    field: 'id',
    cellDataType: 'number',
    hide: true,
    editable: false,
  },
  {
    field: 'name',
    cellDataType: 'text',
  },
  {
    field: 'language',
    cellDataType: 'text',
    enablePivot: true,
    enableRowGroup: true,
  },
  {
    field: 'week_issue_change',
    headerName: 'Issue Change',
    cellDataType: 'number',
    enableValue: true,
  },
  {
    headerName: 'History',
    colId: 'historyLine',
    field: 'history',
    editable: false,
    floatingFilter: false,
    filter: false,
    resizable: true,
    cellDataType: 'numberArray',
    width: 140,
  },
  {
    field: 'github_stars',
    headerName: 'GitHub Stars',
    cellDataType: 'number',
    enableValue: true,
  },
  {
    field: 'popularityRating',
    headerName: 'Popularity',
    cellDataType: 'number',
    enableValue: true,
    width: 130,
  },
  {
    field: 'forks_count',
    headerName: 'Forks',
    cellDataType: 'number',
    enableValue: true,
    width: 150,
  },
  {
    field: 'created_at',
    headerName: 'Created',
    cellDataType: 'date',
  },
  {field: 'has_wiki', headerName: 'Has Wiki', cellDataType: 'boolean'},
  {
    field: 'updated_at',
    headerName: 'Updated',
    cellDataType: 'date',
  },
  {
    field: 'pushed_at',
    headerName: 'Pushed',
    cellDataType: 'date',
  },
  {
    field: 'github_watchers',
    headerName: 'GitHub Watchers',
    cellDataType: 'number',
    enableValue: true,
  },
  {
    field: 'description',
    cellDataType: 'text',
    sortable: false,
  },
  {
    field: 'open_issues_count',
    headerName: 'Open Issues',
    cellDataType: 'number',
    enableValue: true,
  },
  {
    field: 'closed_issues_count',
    headerName: 'Closed Issues',
    cellDataType: 'number',
    enableValue: true,
  },
  {
    field: 'open_pr_count',
    headerName: 'Open PRs',
    cellDataType: 'number',
    enableValue: true,
  },
  {
    field: 'closed_pr_count',
    headerName: 'Closed PRs',
    cellDataType: 'number',
    enableValue: true,
  },
  {field: 'has_projects', headerName: 'Has Projects', cellDataType: 'boolean'},
  {field: 'has_pages', headerName: 'Has Pages', cellDataType: 'boolean'},
  {
    field: 'topics',
    cellDataType: 'textArray',
    editable: false,
    sortable: false,
  },
];
```

**`src/rowData.ts`**

```ts
const rawRowData = [
  {
    id: 10270250,
    name: 'react',
    full_name: 'facebook/react',
    html_url: 'https://github.com/facebook/react',
    description:
      'A declarative, efficient, and flexible JavaScript library for building user interfaces.',
    created_at: new Date('2013-05-24T16:15:54').toDateString(),
    updated_at: new Date('2021-12-20T09:03:49').toDateString(),
    pushed_at: new Date('2021-12-19T14:34:59').toDateString(),
    homepage: 'https://reactjs.org',
    github_stars: 179429,
    language: 'JavaScript',
    forks_count: 36403,
    open_issues_count: 920,
    license: 'MIT License',
    topics: ['declarative', 'frontend', 'javascript', 'library', 'react', 'ui'],
    github_watchers: 6671,
    has_projects: true,
    has_wiki: true,
    has_pages: true,
    closed_issues_count: 10326,
    open_pr_count: 249,
    closed_pr_count: 11408,
    week_issue_change: 5,
    history: [27, 5, 13, 25, 12, 17, 11, 27],
  },
  {
    id: 24195339,
    name: 'angular',
    full_name: 'angular/angular',
    html_url: 'https://github.com/angular/angular',
    description: 'The modern web developer’s platform',
    created_at: new Date('2014-09-18T16:12:01').toDateString(),
    updated_at: new Date('2021-12-20T08:37:07').toDateString(),
    pushed_at: new Date('2021-12-19T21:54:01').toDateString(),
    homepage: 'https://angular.io',
    github_stars: 78348,
    language: 'TypeScript',
    forks_count: 20569,
    open_issues_count: 1889,
    license: 'MIT License',
    topics: [
      'angular',
      'javascript',
      'pwa',
      'typescript',
      'web',
      'web-framework',
      'web-performance',
    ],
    github_watchers: 3119,
    has_projects: true,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 21706,
    open_pr_count: 159,
    closed_pr_count: 20052,
    week_issue_change: 12,
    history: [22, 28, 17, 25, 26, 20, 2, 30, 17, 19, 12, 9, 25, 22, 18],
  },
  {
    id: 11730342,
    name: 'vue',
    full_name: 'vuejs/vue',
    html_url: 'https://github.com/vuejs/vue',
    description:
      '🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.',
    created_at: new Date('2013-07-29T03:24:51').toDateString(),
    updated_at: new Date('2021-12-20T08:47:06').toDateString(),
    pushed_at: new Date('2021-12-20T08:10:16').toDateString(),
    homepage: 'http://vuejs.org',
    github_stars: 191435,
    language: 'JavaScript',
    forks_count: 30945,
    open_issues_count: 546,
    license: 'MIT License',
    topics: ['framework', 'frontend', 'javascript', 'vue'],
    github_watchers: 6187,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 9318,
    open_pr_count: 224,
    closed_pr_count: 1878,
    week_issue_change: -9,
    history: [22, 22, 24, 18, 11, 28],
  },
  {
    id: 74293321,
    name: 'svelte',
    full_name: 'sveltejs/svelte',
    html_url: 'https://github.com/sveltejs/svelte',
    description: 'Cybernetically enhanced web apps',
    created_at: new Date('2016-11-20T18:13:05').toDateString(),
    updated_at: new Date('2021-12-20T08:56:37').toDateString(),
    pushed_at: new Date('2021-12-19T14:53:30').toDateString(),
    homepage: 'https://svelte.dev',
    github_stars: 53935,
    language: 'TypeScript',
    forks_count: 2584,
    open_issues_count: 604,
    license: 'MIT License',
    topics: ['compiler', 'template', 'ui'],
    github_watchers: 874,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 3549,
    open_pr_count: 104,
    closed_pr_count: 2738,
    week_issue_change: 14,
    history: [16, 21, 3, 1, 1, 11, 30, 20, 27, 18],
  },
  {
    id: 224663696,
    name: 'alpine',
    full_name: 'alpinejs/alpine',
    html_url: 'https://github.com/alpinejs/alpine',
    description:
      'A rugged, minimal framework for composing JavaScript behavior in your markup. ',
    created_at: new Date('2019-11-28T13:51:55').toDateString(),
    updated_at: new Date('2021-12-20T08:12:43').toDateString(),
    pushed_at: new Date('2021-12-14T16:02:26').toDateString(),
    homepage: 'https://alpinejs.dev',
    github_stars: 19338,
    language: 'HTML',
    forks_count: 837,
    open_issues_count: 19,
    license: 'MIT License',
    topics: [],
    github_watchers: 202,
    has_projects: false,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 544,
    open_pr_count: 13,
    closed_pr_count: 546,
    week_issue_change: 21,
    history: [15, 13, 26, 8, 19, 12, 25, 12],
  },
  {
    id: 95797174,
    name: 'lit',
    full_name: 'lit/lit',
    html_url: 'https://github.com/lit/lit',
    description:
      'Lit is a simple library for building fast, lightweight web components.',
    created_at: new Date('2017-06-29T16:27:16').toDateString(),
    updated_at: new Date('2021-12-20T07:20:35').toDateString(),
    pushed_at: new Date('2021-12-17T03:45:26').toDateString(),
    homepage: 'https://lit.dev',
    github_stars: 9752,
    language: 'JavaScript',
    forks_count: 528,
    open_issues_count: 207,
    license: 'BSD 3-Clause',
    topics: ['html-templates', 'lit', 'lit-element', 'lit-html'],
    github_watchers: 204,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 895,
    open_pr_count: 53,
    closed_pr_count: 1138,
    week_issue_change: -45,
    history: [17, 16, 23, 16, 3, 7],
  },
  {
    id: 76694515,
    name: 'stimulus',
    full_name: 'hotwired/stimulus',
    html_url: 'https://github.com/hotwired/stimulus',
    description: 'A modest JavaScript framework for the HTML you already have',
    created_at: new Date('2016-12-17T00:19:29').toDateString(),
    updated_at: new Date('2021-12-20T07:20:01').toDateString(),
    pushed_at: new Date('2021-12-17T20:47:34').toDateString(),
    homepage: 'https://stimulus.hotwired.dev/',
    github_stars: 11049,
    language: 'TypeScript',
    forks_count: 316,
    open_issues_count: 17,
    license: 'MIT License',
    topics: [],
    github_watchers: 221,
    has_projects: false,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 282,
    open_pr_count: 5,
    closed_pr_count: 191,
    week_issue_change: -11,
    history: [
      5, 10, 12, 21, 13, 15, 17, 13, 22, 2, 13, 10, 11, 5, 5, 7, 29, 16,
    ],
  },
  {
    id: 1801829,
    name: 'ember.js',
    full_name: 'emberjs/ember.js',
    html_url: 'https://github.com/emberjs/ember.js',
    description:
      'Ember.js - A JavaScript framework for creating ambitious web applications',
    created_at: new Date('2011-05-25T23:39:40').toDateString(),
    updated_at: new Date('2021-12-19T07:57:31').toDateString(),
    pushed_at: new Date('2021-12-20T07:15:54').toDateString(),
    homepage: 'https://emberjs.com',
    github_stars: 22093,
    language: 'JavaScript',
    forks_count: 4253,
    open_issues_count: 427,
    license: 'MIT License',
    topics: ['ember', 'hacktoberfest', 'javascript', 'javascript-framework'],
    github_watchers: 908,
    has_projects: true,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 6187,
    open_pr_count: 94,
    closed_pr_count: 9574,
    week_issue_change: -22,
    history: [
      30, 19, 4, 25, 24, 19, 29, 20, 29, 19, 28, 13, 27, 2, 7, 7, 21, 25, 23,
      15,
    ],
  },
  {
    id: 82095231,
    name: 'stencil',
    full_name: 'ionic-team/stencil',
    html_url: 'https://github.com/ionic-team/stencil',
    description:
      'A toolchain for building scalable, enterprise-ready component systems on top of TypeScript.',
    created_at: new Date('2017-02-15T18:57:07').toDateString(),
    updated_at: new Date('2021-12-20T05:46:50').toDateString(),
    pushed_at: new Date('2021-12-16T21:15:17').toDateString(),
    homepage: 'https://stenciljs.com',
    github_stars: 9884,
    language: 'TypeScript',
    forks_count: 641,
    open_issues_count: 499,
    license: 'Other',
    topics: [
      'custom-elements',
      'ionic',
      'progressive-web-app',
      'pwa',
      'ssg',
      'ssr',
      'static-site-generator',
      'stencil',
      'stenciljs',
      'typescript',
      'webcomponents',
    ],
    github_watchers: 203,
    has_projects: true,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 1929,
    open_pr_count: 46,
    closed_pr_count: 743,
    week_issue_change: 12,
    history: [25, 17, 13, 5, 2, 18, 26, 11, 23, 23],
  },
  {
    id: 130884470,
    name: 'solid',
    full_name: 'solidjs/solid',
    html_url: 'https://github.com/solidjs/solid',
    description:
      'A declarative, efficient, and flexible JavaScript library for building user interfaces.',
    created_at: new Date('2018-04-24T16:36:27').toDateString(),
    updated_at: new Date('2021-12-20T08:29:47').toDateString(),
    pushed_at: new Date('2021-12-19T21:06:01').toDateString(),
    homepage: 'https://solidjs.com',
    github_stars: 13119,
    language: 'TypeScript',
    forks_count: 330,
    open_issues_count: 21,
    license: 'MIT License',
    topics: [
      'declarative',
      'fine-grained',
      'javascript',
      'jsx',
      'performance',
      'proxies',
      'reactive',
      'solid',
    ],
    github_watchers: 161,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 366,
    open_pr_count: 3,
    closed_pr_count: 164,
    week_issue_change: 23,
    history: [14, 22, 5, 13, 5, 30, 28, 15, 19, 11, 28, 24, 4, 2, 10, 30],
  },
  {
    id: 17814354,
    name: 'mithril.js',
    full_name: 'MithrilJS/mithril.js',
    html_url: 'https://github.com/MithrilJS/mithril.js',
    description: 'A JavaScript Framework for Building Brilliant Applications',
    created_at: new Date('2014-03-17T01:59:39').toDateString(),
    updated_at: new Date('2021-12-20T03:17:55').toDateString(),
    pushed_at: new Date('2021-11-24T10:16:47').toDateString(),
    homepage: 'https://mithril.js.org',
    github_stars: 13064,
    language: 'JavaScript',
    forks_count: 940,
    open_issues_count: 173,
    license: 'MIT License',
    topics: [
      'framework',
      'javascript',
      'mithril',
      'router',
      'vdom',
      'virtual-dom',
      'xhr',
    ],
    github_watchers: 324,
    has_projects: true,
    has_wiki: true,
    has_pages: true,
    closed_issues_count: 1368,
    open_pr_count: 28,
    closed_pr_count: 1144,
    week_issue_change: 57,
    history: [25, 18, 2, 23, 19],
  },
  {
    id: 167174,
    name: 'jquery',
    full_name: 'jquery/jquery',
    html_url: 'https://github.com/jquery/jquery',
    description: 'jQuery JavaScript Library',
    created_at: new Date('2009-04-03T15:20:14').toDateString(),
    updated_at: new Date('2021-12-20T06:13:48').toDateString(),
    pushed_at: new Date('2021-12-17T16:50:04').toDateString(),
    homepage: 'https://jquery.com',
    github_stars: 55666,
    language: 'JavaScript',
    forks_count: 20187,
    open_issues_count: 84,
    license: 'MIT License',
    topics: ['jquery'],
    github_watchers: 3306,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 2083,
    open_pr_count: 13,
    closed_pr_count: 2692,
    week_issue_change: 15,
    history: [1, 7, 3, 3, 3, 22, 1, 12, 16, 15, 22],
  },
  {
    id: 5532320,
    name: 'polymer',
    full_name: 'Polymer/polymer',
    html_url: 'https://github.com/Polymer/polymer',
    description: 'Our original Web Component library.',
    created_at: new Date('2012-08-23T20:56:30').toDateString(),
    updated_at: new Date('2021-12-19T05:05:03').toDateString(),
    pushed_at: new Date('2021-12-07T22:20:44').toDateString(),
    homepage: 'https://polymer-library.polymer-project.org/',
    github_stars: 21724,
    language: 'HTML',
    forks_count: 2026,
    open_issues_count: 281,
    license: 'Other',
    topics: ['polymer', 'web-components'],
    github_watchers: 894,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 3648,
    open_pr_count: 26,
    closed_pr_count: 1404,
    week_issue_change: 9,
    history: [5, 6, 25, 7, 17, 6, 19, 27, 21, 5, 18],
  },
  {
    id: 952189,
    name: 'backbone',
    full_name: 'jashkenas/backbone',
    html_url: 'https://github.com/jashkenas/backbone',
    description:
      'Give your JS App some Backbone with Models, Views, Collections, and Events',
    created_at: new Date('2010-09-30T19:41:28').toDateString(),
    updated_at: new Date('2021-12-19T05:50:57').toDateString(),
    pushed_at: new Date('2020-05-19T16:52:55').toDateString(),
    homepage: 'http://backbonejs.org',
    github_stars: 27840,
    language: 'JavaScript',
    forks_count: 5608,
    open_issues_count: 85,
    license: 'MIT License',
    topics: [],
    github_watchers: 1365,
    has_projects: true,
    has_wiki: true,
    has_pages: true,
    closed_issues_count: 2335,
    open_pr_count: 32,
    closed_pr_count: 1797,
    week_issue_change: -14,
    history: [
      25, 26, 4, 14, 6, 22, 1, 4, 24, 28, 6, 28, 13, 22, 24, 8, 8, 8, 8, 27,
    ],
  },
  {
    id: 757363,
    name: 'knockout',
    full_name: 'knockout/knockout',
    html_url: 'https://github.com/knockout/knockout',
    description:
      'Knockout makes it easier to create rich, responsive UIs with JavaScript',
    created_at: new Date('2010-07-05T08:08:34').toDateString(),
    updated_at: new Date('2021-12-18T17:20:52').toDateString(),
    pushed_at: new Date('2021-10-09T07:42:49').toDateString(),
    homepage: 'http://knockoutjs.com/',
    github_stars: 10122,
    language: 'JavaScript',
    forks_count: 1571,
    open_issues_count: 362,
    license: 'Other',
    topics: ['data-binding', 'javascript', 'knockout', 'mvvm'],
    github_watchers: 549,
    has_projects: true,
    has_wiki: true,
    has_pages: true,
    closed_issues_count: 1534,
    open_pr_count: 72,
    closed_pr_count: 670,
    week_issue_change: 63,
    history: [23, 19, 6, 28, 5],
  },
  {
    id: 191051391,
    name: 'redwood',
    full_name: 'redwoodjs/redwood',
    html_url: 'https://github.com/redwoodjs/redwood',
    description: 'The App Framework for Startups',
    created_at: new Date('2019-06-09T20:17:57').toDateString(),
    updated_at: new Date('2021-12-20T01:41:55').toDateString(),
    pushed_at: new Date('2021-12-20T00:37:09').toDateString(),
    homepage: 'https://redwoodjs.com',
    github_stars: 10334,
    language: 'TypeScript',
    forks_count: 431,
    open_issues_count: 269,
    license: 'MIT License',
    topics: [
      'apollo',
      'graphql',
      'hacktoberfest',
      'jamstack',
      'prisma',
      'react',
    ],
    github_watchers: 80,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 1071,
    open_pr_count: 35,
    closed_pr_count: 2602,
    week_issue_change: 14,
    history: [1, 21, 16, 8, 9, 13],
  },
  {
    id: 36040894,
    name: 'gatsby',
    full_name: 'gatsbyjs/gatsby',
    html_url: 'https://github.com/gatsbyjs/gatsby',
    description: 'Build blazing fast, modern apps and websites with React',
    created_at: new Date('2015-05-21T22:43:05').toDateString(),
    updated_at: new Date('2021-12-20T09:04:22').toDateString(),
    pushed_at: new Date('2021-12-20T08:04:34').toDateString(),
    homepage: 'https://www.gatsbyjs.com',
    github_stars: 51931,
    language: 'JavaScript',
    forks_count: 10049,
    open_issues_count: 359,
    license: 'MIT License',
    topics: [
      'blog',
      'compiler',
      'documentation-tool',
      'gatsby',
      'graphql',
      'react',
      'static-site-generator',
      'web-app',
    ],
    github_watchers: 853,
    has_projects: true,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 12975,
    open_pr_count: 180,
    closed_pr_count: 19058,
    week_issue_change: -34,
    history: [10, 13, 12, 22, 4, 14, 27, 11, 18, 9, 21, 12],
  },
  {
    id: 26316966,
    name: 'cyclejs',
    full_name: 'cyclejs/cyclejs',
    html_url: 'https://github.com/cyclejs/cyclejs',
    description:
      'A functional and reactive JavaScript framework for predictable code',
    created_at: new Date('2014-11-07T11:28:45').toDateString(),
    updated_at: new Date('2021-12-20T06:39:49').toDateString(),
    pushed_at: new Date('2021-12-17T11:03:37').toDateString(),
    homepage: 'http://cycle.js.org',
    github_stars: 9999,
    language: 'TypeScript',
    forks_count: 421,
    open_issues_count: 102,
    license: 'MIT License',
    topics: [
      'cyclejs',
      'framework',
      'functional-programming',
      'hacktoberfest',
      'javascript',
      'reactive-programming',
      'rxjs',
      'typescript',
    ],
    github_watchers: 205,
    has_projects: true,
    has_wiki: true,
    has_pages: true,
    closed_issues_count: 563,
    open_pr_count: 26,
    closed_pr_count: 301,
    week_issue_change: -2,
    history: [27, 19, 25, 1, 17, 16, 9, 17, 1, 25, 24, 13, 26, 7, 12, 7, 5],
  },
  {
    id: 42283287,
    name: 'preact',
    full_name: 'preactjs/preact',
    html_url: 'https://github.com/preactjs/preact',
    description:
      '⚛️ Fast 3kB React alternative with the same modern API. Components & Virtual DOM.',
    created_at: new Date('2015-09-11T02:40:18').toDateString(),
    updated_at: new Date('2021-12-20T09:02:15').toDateString(),
    pushed_at: new Date('2021-12-17T23:21:58').toDateString(),
    homepage: 'https://preactjs.com',
    github_stars: 30538,
    language: 'JavaScript',
    forks_count: 1702,
    open_issues_count: 222,
    license: 'MIT License',
    topics: [
      'components',
      'dom',
      'jsx',
      'preact',
      'react',
      'vdom',
      'virtual-dom',
    ],
    github_watchers: 425,
    has_projects: true,
    has_wiki: true,
    has_pages: true,
    closed_issues_count: 1309,
    open_pr_count: 78,
    closed_pr_count: 1729,
    week_issue_change: -12,
    history: [
      18, 3, 17, 22, 11, 26, 6, 1, 21, 16, 12, 13, 15, 19, 11, 12, 10, 21, 3,
    ],
  },
  {
    id: 13142126,
    name: 'riot',
    full_name: 'riot/riot',
    html_url: 'https://github.com/riot/riot',
    description: 'Simple and elegant component-based UI library',
    created_at: new Date('2013-09-27T05:21:01').toDateString(),
    updated_at: new Date('2021-12-20T05:17:31').toDateString(),
    pushed_at: new Date('2021-12-17T20:09:25').toDateString(),
    homepage: 'https://riot.js.org',
    github_stars: 14597,
    language: 'JavaScript',
    forks_count: 1032,
    open_issues_count: 5,
    license: 'Other',
    topics: [
      'client-side',
      'customelement',
      'customelements',
      'customtags',
      'elegant',
      'framework',
      'javascript',
      'lite',
      'minimal',
      'simple',
      'view',
      'webcomponents',
    ],
    github_watchers: 412,
    has_projects: true,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 2147,
    open_pr_count: 0,
    closed_pr_count: 755,
    week_issue_change: 0,
    history: [26, 30, 10, 4, 5, 29, 8, 8, 2, 28, 17, 10, 27, 18, 8, 20],
  },
  {
    id: 121594173,
    name: 'aurelia',
    full_name: 'aurelia/aurelia',
    html_url: 'https://github.com/aurelia/aurelia',
    description:
      'Aurelia 2, a standards-based, front-end framework designed for high-performing, ambitious applications.',
    created_at: new Date('2018-02-15T05:22:58').toDateString(),
    updated_at: new Date('2021-12-19T04:23:43').toDateString(),
    pushed_at: new Date('2021-11-28T16:21:43').toDateString(),
    homepage: '',
    github_stars: 1142,
    language: 'TypeScript',
    forks_count: 121,
    open_issues_count: 143,
    license: 'MIT License',
    topics: [
      'aurelia',
      'cordova',
      'cross-platform',
      'electron',
      'framework',
      'frontend',
      'html',
      'javascript',
      'javascript-framework',
      'mobile',
      'pwa',
      'single-page-applications',
      'spa',
      'typescript',
      'web',
      'web-framework',
      'web-performance',
    ],
    github_watchers: 66,
    has_projects: true,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 214,
    open_pr_count: 17,
    closed_pr_count: 959,
    week_issue_change: 32,
    history: [13, 6, 10, 15, 16, 30, 25, 1],
  },
  {
    id: 70107786,
    name: 'next.js',
    full_name: 'vercel/next.js',
    html_url: 'https://github.com/vercel/next.js',
    description: 'The React Framework',
    created_at: new Date('2016-10-05T23:32:51').toDateString(),
    updated_at: new Date('2021-12-20T08:57:47').toDateString(),
    pushed_at: new Date('2021-12-20T08:21:58').toDateString(),
    homepage: 'https://nextjs.org',
    github_stars: 78446,
    language: 'JavaScript',
    forks_count: 15787,
    open_issues_count: 1361,
    license: 'MIT License',
    topics: [
      'blog',
      'browser',
      'compiler',
      'components',
      'hybrid',
      'nextjs',
      'node',
      'react',
      'server-rendering',
      'ssg',
      'static',
      'static-site-generator',
      'universal',
      'vercel',
    ],
    github_watchers: 1224,
    has_projects: false,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 10320,
    open_pr_count: 254,
    closed_pr_count: 9849,
    week_issue_change: 63,
    history: [30, 5, 1, 5, 18, 2, 13, 25, 27, 26, 20, 25, 18, 35],
  },
  {
    id: 71995937,
    name: 'nuxt.js',
    full_name: 'nuxt/nuxt.js',
    html_url: 'https://github.com/nuxt/nuxt.js',
    description: 'The Intuitive Vue(2) Framework',
    created_at: new Date('2016-10-26T11:18:47').toDateString(),
    updated_at: new Date('2021-12-20T08:27:45').toDateString(),
    pushed_at: new Date('2021-12-20T08:05:15').toDateString(),
    homepage: 'https://nuxtjs.org',
    github_stars: 38997,
    language: 'JavaScript',
    forks_count: 3157,
    open_issues_count: 464,
    license: 'Other',
    topics: [
      'framework',
      'isomorphic',
      'nuxt',
      'server-rendering',
      'ssr',
      'universal',
      'vue',
      'vue-router',
      'vuex',
      'web-app',
    ],
    github_watchers: 772,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 6129,
    open_pr_count: 30,
    closed_pr_count: 2869,
    week_issue_change: -18,
    history: [
      30, 4, 6, 28, 17, 30, 30, 20, 7, 26, 17, 4, 6, 3, 21, 24, 27, 30, 6, 5,
    ],
  },
  {
    id: 3214406,
    name: 'meteor',
    full_name: 'meteor/meteor',
    html_url: 'https://github.com/meteor/meteor',
    description: 'Meteor, the JavaScript App Platform',
    created_at: new Date('2012-01-19T01:58:17').toDateString(),
    updated_at: new Date('2021-12-20T06:36:27').toDateString(),
    pushed_at: new Date('2021-12-17T18:10:08').toDateString(),
    homepage: 'https://www.meteor.com',
    github_stars: 42742,
    language: 'JavaScript',
    forks_count: 5187,
    open_issues_count: 120,
    license: 'Other',
    topics: [
      'build-system',
      'framework',
      'hacktoberfest',
      'javascript',
      'meteor',
      'mongodb',
      'nodejs',
      'npm',
      'reactive-programming',
      'zero-configuration',
    ],
    github_watchers: 1642,
    has_projects: true,
    has_wiki: true,
    has_pages: false,
    closed_issues_count: 8537,
    open_pr_count: 24,
    closed_pr_count: 2998,
    week_issue_change: 21,
    history: [29, 30, 28, 20, 1, 24],
  },
  {
    id: 43695474,
    name: 'quasar',
    full_name: 'quasarframework/quasar',
    html_url: 'https://github.com/quasarframework/quasar',
    description:
      'Quasar Framework - Build high-performance VueJS user interfaces in record time',
    created_at: new Date('2015-10-05T15:45:36').toDateString(),
    updated_at: new Date('2021-12-20T08:26:07').toDateString(),
    pushed_at: new Date('2021-12-19T23:18:50').toDateString(),
    homepage: 'https://quasar.dev',
    github_stars: 20095,
    language: 'JavaScript',
    forks_count: 2543,
    open_issues_count: 367,
    license: 'MIT License',
    topics: [
      'android',
      'browser-extension',
      'electron',
      'ios',
      'javascript',
      'material',
      'material-components',
      'material-design',
      'material-theme',
      'pwa',
      'quasar-framework',
      'server-side-rendering',
      'ssr',
      'vue',
      'vue-component',
      'vue-components',
      'vue2',
      'vuejs',
      'vuejs2',
    ],
    github_watchers: 488,
    has_projects: false,
    has_wiki: false,
    has_pages: false,
    closed_issues_count: 6097,
    open_pr_count: 97,
    closed_pr_count: 3424,
    week_issue_change: 1,
    history: [26, 12, 7, 13, 17, 18, 20, 1, 28, 23, 22, 2, 2, 22, 18, 29, 2],
  },
];

export const rowData = rawRowData.map(row => ({
  ...row,
  popularityRating:
    Math.round(Math.min(5, Math.max(0.5, (row.github_stars / 200000) * 5)) * 2) /
    2,
}));
```

## Gradient Style

The [Gradient Style](https://www.adaptabletools.com/docs/handbook-styled-column-gradient/index.md) will colour **numeric** cells by comparing their value against a maximum value.

This maximum value can be the highest value in the Column or in a given Range.

- Gradients can be reversed so the colour is lighter (rather than darker) the nearer it is to the max value
- You can also provide a Zero-centred gradient for columns that also contain negative numbers

## Percent Bar Style

In the [Percent Bar Style](https://www.adaptabletools.com/docs/handbook-styled-column-percent-bar/index.md) each cell in the numeric column displays as a relatively sized bar, evaluated using either the cell's actual value or its relative percentage value.

Percent Bar Styles can include multiple Ranges and be styled to show a back colour, Cell Text or a Tooltip.

## Badge Style

In the [Badge Style](https://www.adaptabletools.com/docs/handbook-styled-column-badge/index.md) each cell in a numeric or text column can be rendered as a Badge.

A Badge can include the Cell Text, or an Icon, or both.

Rules can be provided to determine whether the Badge is displayed.

This allows you to provide multiple different badge styles for a column depending on the cell value

## Sparkline Column

The [Sparkline Column](https://www.adaptabletools.com/docs/handbook-styled-column-sparkline/index.md) style displays an AG Grid sparkline in each cell.

These are array columns, typically numeric, but tuple and object arrays are also supported.

## Bullet Chart Style

The [Bullet Chart Style](https://www.adaptabletools.com/docs/handbook-styled-column-bullet/index.md) renders a [bullet graph](https://en.wikipedia.org/wiki/Bullet_graph) in each cell of a numeric column.

Each cell shows three things in a single row of pixels: the actual value (a bar), a target value (a marker) and optional qualitative bands (e.g. poor / ok / good).

Bullet Charts are particularly useful for KPI columns where each row's value should be compared against a target and classified into a qualitative band.

- Bullet Charts also support `Col-Avg` and `Col-Median` as dynamic band/target endpoints
- The bands and markers can adapt automatically as the data changes

## Rating Style

The [Rating Column Style](https://www.adaptabletools.com/docs/handbook-styled-column-rating/index.md) turns a numeric column into a row of repeated icons (such as stars or hearts).

The filled portion reflects the cell value against configurable maximum (with optional half-icon for fractions).

Use the Rating Style when you want a compact, familiar “score out of five” (or similar) visual

## Range Bar Style

The [Range Bar Style](https://www.adaptabletools.com/docs/handbook-styled-column-range-bar/index.md) draws a horizontal track between a minimum and maximum for each numeric cell.

It includes a marker for the cell value and an optional second marker for a reference value.

Optional qualitative bands can tint regions of the track.

It suits KPIs where you need to see “where am I on the scale?” and optionally compare to a benchmark in the same glance.

## Icon Column Style

The [Icon Column Style](https://www.adaptabletools.com/docs/handbook-styled-column-icon/index.md) maps each cell’s value to a visual (emoji, system icon, or image URL).

Built-in presets (for example flags or status) can be combined with your own key–icon pairs; unmatched values can be hidden or shown as raw text or a fallback icon.

Icon columns work on **any** column data type that can be matched as text or a discrete key (not just numeric columns)

## Row Scope

AdapTable allows both run-time and design-time users to decide which Rows will be included in the Style.

This is done using the `RowScope` property which controls 4 kinds of Rows:

- **Data** — leaf data rows
- **Group** — group rows (when AG Grid Row Grouping is active)
- **Summary** — pinned summary rows
- **Total** — grand-total rows

All Styled Columns can render on all row kinds, with the sole exception of **Sparkline** (which supports Data rows only)

When `RowScope` is not explicitly set, AdapTable picks a sensible **per-type default**:

| Styled Column        | Default row kinds                            |
| -------------------- | -------------------------------------------- |
| **Badge**            | All four — Data, Group, Summary and Total    |
| **Sparkline**        | Data only (the others aren't supported)      |
| **All other Styles** | Data, Summary and Total (**Group excluded**) |

- Only `Badge` includes Grouped Rows by default because aggregated values rarely make sense for other Styles
- AdapTable still allows rendering Styles on Group rows because the Aggregation doesn't have to be `sum`
- For example, it could be `min` or `max`, in which case the rendering would fit in with the rest of the column

- The Styled Column's Tooltip (`ToolTipText`) follows the Row Scope: it is shown only on rows where the Style is rendered
- On other rows the cell shows the Column Definition's own `tooltip`, if one is set

### Understanding the RowScope object

### Shape

`RowScope` is an object based on **Exclude flags**.

When a flag is `true` the row kind is **not** rendered; missing flags default to **include**:

```ts
RowScope: {
  ExcludeDataRows?: boolean;
  ExcludeGroupRows?: boolean;
  ExcludeSummaryRows?: boolean;
  ExcludeTotalRows?: boolean;
}
```

For example, to opt a Gradient column **into** Group rows (overriding the default):

```ts
{
  ColumnId: 'closed_pr_count',
  Name: 'Closed PR Gradient',
  GradientStyle: { /* ... */ },
  RowScope: {
    ExcludeGroupRows: false,
  },
}
```

- Unsupported row kinds (e.g. Group on a Sparkline) are always enforced off
- Even if the persisted `RowScope` explicitly tries to include them, AdapTable strips the flag at load time

- The Scope step of the Styled Column Wizard greys out and disables unsupported row kinds
- This ensures that they cannot be ticked at run-time

## Using Styled Columns

Run-time users are able to add, edit, share, suspend and delete Styled Columns using the Styled Column section in the [Settings Panel](https://www.adaptabletools.com/docs/ui-settings-panel/index.md).

### Column Menu

A menu item in the [Column Menu](https://www.adaptabletools.com/docs/ui-column-menu/index.md) opens the Styled Column wizard for the selected column.

Labels follow a consistent pattern:

- **Create …** when no Styled Column exists for that column yet
- **Edit …** when one already does (for example _Edit Gradient Column_)

Which **create** actions appear depends on the column’s **data type** :

- `Badge` and `Icon` are offered on several types because they do not assume a numeric scale
- Numeric-only styles are only listed for numeric columns

| Column type  | Styles available in Menu                                                          |
| ------------ | --------------------------------------------------------------------------------- |
| Numeric      | `Gradient`, `Percent Bar`, `Bullet Chart`, `Range Bar`, `Rating`, `Badge`, `Icon` |
| String       | `Badge`, `Icon`                                                                   |
| String array | `Badge`                                                                           |
| Number array | `Badge`, `Sparkline`                                                              |

- When editing, the wizard opens on a sensible first step for that style
- For example **Ranges** for Gradient or Percent Bar, **Mappings** for Icon, **Style** for Range Bar

For full control over ordering and visibility of menu items, see [Column Menu Options](https://www.adaptabletools.com/docs/technical-reference-column-menu/index.md).

## UI Entitlements

The UI Entitlements behaviour for Styled Columns is as expected for `Full` and `Hidden` [`Access Levels`](https://www.adaptabletools.com/docs/reference/accesslevel.md).

The `ReadOnly` Entitlement behaviour is that the Styled Columns will still be rendered but Users are not permitted to manage or suspend the Style definitions.

### FAQ

**Can I apply more than one Styled Column to the same column?**
No. A column can have at most one Styled Column at a time, and all the types are distinct and mutually exclusive.
They all provide different ways to display column data and each has a separate implementation.
The wizard reflects this by asking you to pick the **Type** on the Settings step.

**What's the difference between a Badge and an Icon Column?**
Both can show a small visual in a cell, but they answer different questions:

- **Badge** is _rule-driven_: each badge is shown when the rule matches the cell (or always, if no Rule is given). A badge is a pill with optional text and an optional icon and you can configure multiple badges per column.
- **Icon Column** is _value-mapped_: it uses **Key → Icon** mappings and the renderer looks up the cell's value to find the matching icon. There is exactly one icon per cell, with configurable fallback behaviour for unmatched values.

- Use a Badge when you want rule-based visual labels with optional text
- Use an Icon Column when each value should map to a single, fixed glyph (e.g. flag or currency)

**Why is a Styled Column (e.g. Percent Bar or Gradient) not shown on grouped or summary rows?**
Each Styled Column type defines which **row kinds** (data, group, summary, total) it can render on, and the wizard includes a **Scope** step to choose columns and those row kinds.
Some types are intended only for leaf data rows (for example sparklines). If a style does not appear on an aggregated row, check the Styled Column's **Row scope** in the wizard or in Adaptable State — not all types apply to every row kind.

**How do Styled Columns interact with Format Columns on the same cell?**
Styled Columns _claim_ specific style slices and override the matching Format Column properties for those slices.
In practice that means:

- The renderer-owned visuals (gradient tint, percent bar, badge pill, sparkline, bullet chart geometry, rating icons, range track, icon glyph) always come from the Styled Column.
- Where a Styled Column exposes a `Font` and/or `Cell` slice in its wizard (e.g. Gradient, Percent Bar, Bullet Chart, Rating, Badge, Icon), those properties take precedence over the Format Column for the same column.
- Anything the Styled Column leaves unset still inherits normally from any matching Format Column.

**Can I temporarily turn a Styled Column off without deleting it?**
Yes. Every Styled Column can be suspended from the Styled Column section in the [Settings Panel](https://www.adaptabletools.com/docs/ui-settings-panel/index.md).
A suspended Styled Column keeps its definition but does not render — useful for quickly comparing styled vs. unstyled, or temporarily disabling a rule.

**Why does my Styled Column not appear after I set it in Initial State?**
The most common reasons are:

- The Styled Column's `ColumnId` doesn't match a column in the grid (typos, or the column hasn't been added yet)
- The wrong type is configured for the column's data type (for example a Gradient on a string column)
- The Styled Column is suspended or read-only in a way that hides it
- For aggregated rows: the Row Scope excludes the row kind you're looking at

Use `getStyledColumnForColumnId` in Styled Column API at runtime to check if a Styled Column exists
