Horizon folds
Horizon folds
0.1
| Observation | Value |
|---|---|
| API · 0 | 19 |
| API · 1 | 28 |
| API · 2 | 25 |
| API · 3 | 17 |
| API · 4 | 14 |
| API · 5 | 16 |
| API · 6 | 18 |
| API · 7 | 11 |
| API · 8 | -7 |
| API · 9 | -31 |
| API · 10 | -48 |
| API · 11 | -47 |
| API · 12 | -27 |
| API · 13 | 4 |
| API · 14 | 32 |
| API · 15 | 44 |
| API · 16 | 38 |
| API · 17 | 21 |
| API · 18 | 5 |
| API · 19 | -3 |
| API · 20 | -4 |
| API · 21 | -5 |
| API · 22 | -13 |
| API · 23 | -26 |
| API · 24 | -38 |
| Storage · 0 | 35 |
| Storage · 1 | 51 |
| Storage · 2 | 47 |
| Storage · 3 | 26 |
| Storage · 4 | -1 |
| Storage · 5 | -21 |
| Storage · 6 | -26 |
| Storage · 7 | -22 |
| Storage · 8 | -16 |
| Storage · 9 | -15 |
| Storage · 10 | -19 |
| Storage · 11 | -19 |
| Storage · 12 | -10 |
| Storage · 13 | 11 |
| Storage · 14 | 36 |
| Storage · 15 | 50 |
| Storage · 16 | 45 |
| Storage · 17 | 22 |
| Storage · 18 | -10 |
| Storage · 19 | -35 |
| Storage · 20 | -43 |
| Storage · 21 | -34 |
| Storage · 22 | -17 |
| Storage · 23 | -4 |
| Storage · 24 | 1 |
| Workers · 0 | 26 |
| Workers · 1 | 38 |
| Workers · 2 | 37 |
| Workers · 3 | 19 |
| Workers · 4 | -11 |
| Workers · 5 | -39 |
| Workers · 6 | -52 |
| Workers · 7 | -44 |
| Workers · 8 | -21 |
| Workers · 9 | 5 |
| Workers · 10 | 21 |
| Workers · 11 | 24 |
| Workers · 12 | 19 |
| Workers · 13 | 15 |
| Workers · 14 | 17 |
| Workers · 15 | 21 |
| Workers · 16 | 20 |
| Workers · 17 | 7 |
| Workers · 18 | -16 |
| Workers · 19 | -40 |
| Workers · 20 | -51 |
| Workers · 21 | -42 |
| Workers · 22 | -16 |
| Workers · 23 | 15 |
| Workers · 24 | 37 |
| Search · 0 | 4 |
| Search · 1 | -1 |
| Search · 2 | -2 |
| Search · 3 | -4 |
| Search · 4 | -15 |
| Search · 5 | -30 |
| Search · 6 | -40 |
| Search · 7 | -36 |
| Search · 8 | -14 |
| Search · 9 | 17 |
| Search · 10 | 43 |
| Search · 11 | 52 |
| Search · 12 | 40 |
| Search · 13 | 16 |
| Search · 14 | -8 |
| Search · 15 | -21 |
| Search · 16 | -22 |
| Search · 17 | -17 |
| Search · 18 | -15 |
| Search · 19 | -19 |
| Search · 20 | -23 |
| Search · 21 | -20 |
| Search · 22 | -4 |
| Search · 23 | 21 |
| Search · 24 | 44 |
Usage
Import the component and the stylesheet once. See Getting started to install the package.
import { HorizonFoldsCard } from '@lilt-ui/charts';
import '@lilt-ui/charts/styles.css';<HorizonFoldsCard data={serviceHorizons} series="series" time="time" value="value" />Omit title to leave out the visible title. Set header={false} to remove the whole header, and use aria-label to name a chart inside your own card. legend={false} removes the legend independently. surface="ghost" controls only the visual frame. See Card composition.
Data
One row per series and numeric time. Samples sort by time within each series. All series share one absolute magnitude scale. Positive values use the first palette color and negative values use the fourth; deeper color represents higher bands. Missing samples break the shape. Inspection reports the original signed value, and the resting headline is the mean of known values.
const serviceHorizons = [
{
"series": "API",
"time": 0,
"value": 19
},
{
"series": "API",
"time": 1,
"value": 28
},
{
"series": "API",
"time": 2,
"value": 25
},
{
"series": "API",
"time": 3,
"value": 17
},
{
"series": "API",
"time": 4,
"value": 14
},
{
"series": "API",
"time": 5,
"value": 16
},
{
"series": "API",
"time": 6,
"value": 18
},
{
"series": "API",
"time": 7,
"value": 11
},
{
"series": "API",
"time": 8,
"value": -7
},
{
"series": "API",
"time": 9,
"value": -31
},
{
"series": "API",
"time": 10,
"value": -48
},
{
"series": "API",
"time": 11,
"value": -47
},
{
"series": "API",
"time": 12,
"value": -27
},
{
"series": "API",
"time": 13,
"value": 4
},
{
"series": "API",
"time": 14,
"value": 32
},
{
"series": "API",
"time": 15,
"value": 44
},
{
"series": "API",
"time": 16,
"value": 38
},
{
"series": "API",
"time": 17,
"value": 21
},
{
"series": "API",
"time": 18,
"value": 5
},
{
"series": "API",
"time": 19,
"value": -3
},
{
"series": "API",
"time": 20,
"value": -4
},
{
"series": "API",
"time": 21,
"value": -5
},
{
"series": "API",
"time": 22,
"value": -13
},
{
"series": "API",
"time": 23,
"value": -26
},
{
"series": "API",
"time": 24,
"value": -38
},
{
"series": "Storage",
"time": 0,
"value": 35
},
{
"series": "Storage",
"time": 1,
"value": 51
},
{
"series": "Storage",
"time": 2,
"value": 47
},
{
"series": "Storage",
"time": 3,
"value": 26
},
{
"series": "Storage",
"time": 4,
"value": -1
},
{
"series": "Storage",
"time": 5,
"value": -21
},
{
"series": "Storage",
"time": 6,
"value": -26
},
{
"series": "Storage",
"time": 7,
"value": -22
},
{
"series": "Storage",
"time": 8,
"value": -16
},
{
"series": "Storage",
"time": 9,
"value": -15
},
{
"series": "Storage",
"time": 10,
"value": -19
},
{
"series": "Storage",
"time": 11,
"value": -19
},
{
"series": "Storage",
"time": 12,
"value": -10
},
{
"series": "Storage",
"time": 13,
"value": 11
},
{
"series": "Storage",
"time": 14,
"value": 36
},
{
"series": "Storage",
"time": 15,
"value": 50
},
{
"series": "Storage",
"time": 16,
"value": 45
},
{
"series": "Storage",
"time": 17,
"value": 22
},
{
"series": "Storage",
"time": 18,
"value": -10
},
{
"series": "Storage",
"time": 19,
"value": -35
},
{
"series": "Storage",
"time": 20,
"value": -43
},
{
"series": "Storage",
"time": 21,
"value": -34
},
{
"series": "Storage",
"time": 22,
"value": -17
},
{
"series": "Storage",
"time": 23,
"value": -4
},
{
"series": "Storage",
"time": 24,
"value": 1
},
{
"series": "Workers",
"time": 0,
"value": 26
},
{
"series": "Workers",
"time": 1,
"value": 38
},
{
"series": "Workers",
"time": 2,
"value": 37
},
{
"series": "Workers",
"time": 3,
"value": 19
},
{
"series": "Workers",
"time": 4,
"value": -11
},
{
"series": "Workers",
"time": 5,
"value": -39
},
{
"series": "Workers",
"time": 6,
"value": -52
},
{
"series": "Workers",
"time": 7,
"value": -44
},
{
"series": "Workers",
"time": 8,
"value": -21
},
{
"series": "Workers",
"time": 9,
"value": 5
},
{
"series": "Workers",
"time": 10,
"value": 21
},
{
"series": "Workers",
"time": 11,
"value": 24
},
{
"series": "Workers",
"time": 12,
"value": 19
},
{
"series": "Workers",
"time": 13,
"value": 15
},
{
"series": "Workers",
"time": 14,
"value": 17
},
{
"series": "Workers",
"time": 15,
"value": 21
},
{
"series": "Workers",
"time": 16,
"value": 20
},
{
"series": "Workers",
"time": 17,
"value": 7
},
{
"series": "Workers",
"time": 18,
"value": -16
},
{
"series": "Workers",
"time": 19,
"value": -40
},
{
"series": "Workers",
"time": 20,
"value": -51
},
{
"series": "Workers",
"time": 21,
"value": -42
},
{
"series": "Workers",
"time": 22,
"value": -16
},
{
"series": "Workers",
"time": 23,
"value": 15
},
{
"series": "Workers",
"time": 24,
"value": 37
},
{
"series": "Search",
"time": 0,
"value": 4
},
{
"series": "Search",
"time": 1,
"value": -1
},
{
"series": "Search",
"time": 2,
"value": -2
},
{
"series": "Search",
"time": 3,
"value": -4
},
{
"series": "Search",
"time": 4,
"value": -15
},
{
"series": "Search",
"time": 5,
"value": -30
},
{
"series": "Search",
"time": 6,
"value": -40
},
{
"series": "Search",
"time": 7,
"value": -36
},
{
"series": "Search",
"time": 8,
"value": -14
},
{
"series": "Search",
"time": 9,
"value": 17
},
{
"series": "Search",
"time": 10,
"value": 43
},
{
"series": "Search",
"time": 11,
"value": 52
},
{
"series": "Search",
"time": 12,
"value": 40
},
{
"series": "Search",
"time": 13,
"value": 16
},
{
"series": "Search",
"time": 14,
"value": -8
},
{
"series": "Search",
"time": 15,
"value": -21
},
{
"series": "Search",
"time": 16,
"value": -22
},
{
"series": "Search",
"time": 17,
"value": -17
},
{
"series": "Search",
"time": 18,
"value": -15
},
{
"series": "Search",
"time": 19,
"value": -19
},
{
"series": "Search",
"time": 20,
"value": -23
},
{
"series": "Search",
"time": 21,
"value": -20
},
{
"series": "Search",
"time": 22,
"value": -4
},
{
"series": "Search",
"time": 23,
"value": 21
},
{
"series": "Search",
"time": 24,
"value": 44
}
];Props
Every prop HorizonFoldsCard accepts, in the order you are likely to reach for them.
| Prop | Type | Description |
|---|---|---|
title | string | Optional visible title. Omit to render no title. Also supplies the accessible name unless aria-label is set. |
header | boolean | Defaults to true. False removes the whole header: title, headline, delta and period controls, with no reserved space. Pass data directly when your app owns period selection. |
aria-label | string | Accessible chart name, independent of the visible title. Falls back to title, then a generic chart name. |
data | Row[] | One row per observation. Omit when using ranges. |
height | number | Minimum plot height, default 330px. Dense data may expand within the scrollable viewport. |
depth | boolean | Lit tiles, solid bars, or spheres. Data positions remain exact; loading keeps the same depth treatment. |
color | string | Override the palette with one CSS color. |
headline | number | Override the resting headline. |
delta | number | Fractional change shown alongside the headline. |
deltaTone | 'default' | 'inverse' | 'neutral' | Use inverse when a decrease is good. |
range | string | Static period label. |
ranges | { id, label, data, headline?, delta? }[] | Period choices with their own data. |
defaultRange | string | Initial period id. |
locale | string | Locale for numbers and dates; defaults to en-US. |
formatValue | (value: number) => string | Custom value formatter. |
badge | ReactNode | Content for the glass tab above the card. |
className | string | Class on the card frame. |
style | CSSProperties | ChartStyle | Inline styles and scoped chart variables. |
onSelectionChange | (selection | null) => void | Reports id, original row (or null for an absent day), value, and pinned state. |
renderReadout | (selection | null) => ReactNode | Consumer-owned readout, including when the header is hidden. |
valueFormat | Intl.NumberFormatOptions | Formats the headline, tiles, and axis, e.g. currency. |
surface | 'elevated' | 'outline' | 'ghost' | Card treatment. Ghost removes the visual frame only; header and legend are independent controls. |
palette | 'iris' | 'cobalt' | 'emerald' | Series colors. Iris by default; explicit series colors still win. |
numberStyle | 'count' | 'pop' | 'slide' | 'roll' | 'flow' | 'scramble' | How the headline animates when its value changes. Count (default) counts to the new value. |
loading | boolean | Shows a neutral loading skeleton, not data. |
loadingStyle | 'shimmer' | 'draw' | 'breathe' | Shimmer sweeps a highlight over still shapes; draw reveals them in order; breathe lets them settle. Follows the selected look, including depth, and respects reduced motion. |
empty | 'dots' | 'shape' | ReactElement | null | What the card shows when the period has no data. Dots (default) gathers a quiet dot field around the message; shape lays the chart’s own outline behind it. Pass `<ChartEmpty>` with your own words, any element of your own, or null for nothing. Both looks stay still, so empty never reads as loading, and the headline reads a dash, never zero. |
motion | 'auto' | 'none' | None turns off decorative motion; reduced motion does this automatically. |
series | text key of Row | Series label; each series retains one track. |
time | numeric key of Row | Finite numeric time. Samples are sorted within each series. |
value | numeric key of Row | Signed numeric measurement. Null or undefined is missing. |
bands | number | Number of folded magnitude bands, 2 to 5. Default 3. |
aggregate | 'sum' | 'mean' | 'max' | Fallback resting summary. A family-defined summary (such as located point count, hierarchy total, or mean signed value) takes precedence. Use headline to override that summary. |
onKeyDown | KeyboardEventHandler<HTMLElement> | Keyboard handler on the card frame. Chart inspection also has its own keyboard handling. |
legendSwatch | 'square' | 'dot' | 'line' | Marker beside each group label, where a group legend is present. Defaults to square. |
legend | false | 'tiles' | 'inline' | 'list' | 'pills' | 'bars' | Layout for the group legend where the data produces groups. False hides it; defaults to tiles. |