@danielmcsheehy/isopleth 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/auto.d.ts +61 -0
- package/dist/auto.d.ts.map +1 -0
- package/dist/auto.js +213 -0
- package/dist/auto.js.map +1 -0
- package/dist/backend/index.d.ts +24 -0
- package/dist/backend/index.d.ts.map +1 -0
- package/dist/backend/index.js +42 -0
- package/dist/backend/index.js.map +1 -0
- package/dist/backend/js/index.d.ts +7 -0
- package/dist/backend/js/index.d.ts.map +1 -0
- package/dist/backend/js/index.js +33 -0
- package/dist/backend/js/index.js.map +1 -0
- package/dist/backend/js/insights.d.ts +30 -0
- package/dist/backend/js/insights.d.ts.map +1 -0
- package/dist/backend/js/insights.js +663 -0
- package/dist/backend/js/insights.js.map +1 -0
- package/dist/backend/js/kernels.d.ts +22 -0
- package/dist/backend/js/kernels.d.ts.map +1 -0
- package/dist/backend/js/kernels.js +562 -0
- package/dist/backend/js/kernels.js.map +1 -0
- package/dist/backend/js/stats.d.ts +26 -0
- package/dist/backend/js/stats.d.ts.map +1 -0
- package/dist/backend/js/stats.js +237 -0
- package/dist/backend/js/stats.js.map +1 -0
- package/dist/backend/types.d.ts +139 -0
- package/dist/backend/types.d.ts.map +1 -0
- package/dist/backend/types.js +12 -0
- package/dist/backend/types.js.map +1 -0
- package/dist/backend/wasm-wrap.d.ts +9 -0
- package/dist/backend/wasm-wrap.d.ts.map +1 -0
- package/dist/backend/wasm-wrap.js +52 -0
- package/dist/backend/wasm-wrap.js.map +1 -0
- package/dist/backend/wasm.d.ts +30 -0
- package/dist/backend/wasm.d.ts.map +1 -0
- package/dist/backend/wasm.js +29 -0
- package/dist/backend/wasm.js.map +1 -0
- package/dist/channel.d.ts +41 -0
- package/dist/channel.d.ts.map +1 -0
- package/dist/channel.js +205 -0
- package/dist/channel.js.map +1 -0
- package/dist/chart.d.ts +70 -0
- package/dist/chart.d.ts.map +1 -0
- package/dist/chart.js +68 -0
- package/dist/chart.js.map +1 -0
- package/dist/compile/index.d.ts +28 -0
- package/dist/compile/index.d.ts.map +1 -0
- package/dist/compile/index.js +391 -0
- package/dist/compile/index.js.map +1 -0
- package/dist/compile/palette.d.ts +41 -0
- package/dist/compile/palette.d.ts.map +1 -0
- package/dist/compile/palette.js +102 -0
- package/dist/compile/palette.js.map +1 -0
- package/dist/compile/resolve.d.ts +41 -0
- package/dist/compile/resolve.d.ts.map +1 -0
- package/dist/compile/resolve.js +155 -0
- package/dist/compile/resolve.js.map +1 -0
- package/dist/compile/scales.d.ts +49 -0
- package/dist/compile/scales.d.ts.map +1 -0
- package/dist/compile/scales.js +348 -0
- package/dist/compile/scales.js.map +1 -0
- package/dist/compile/series.d.ts +65 -0
- package/dist/compile/series.d.ts.map +1 -0
- package/dist/compile/series.js +948 -0
- package/dist/compile/series.js.map +1 -0
- package/dist/editor/index.d.ts +46 -0
- package/dist/editor/index.d.ts.map +1 -0
- package/dist/editor/index.js +342 -0
- package/dist/editor/index.js.map +1 -0
- package/dist/index.d.ts +47 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +41 -0
- package/dist/index.js.map +1 -0
- package/dist/insights/index.d.ts +21 -0
- package/dist/insights/index.d.ts.map +1 -0
- package/dist/insights/index.js +461 -0
- package/dist/insights/index.js.map +1 -0
- package/dist/interval.d.ts +19 -0
- package/dist/interval.d.ts.map +1 -0
- package/dist/interval.js +166 -0
- package/dist/interval.js.map +1 -0
- package/dist/isopleth.browser.js +44 -0
- package/dist/isopleth.browser.js.LEGAL.txt +28 -0
- package/dist/isopleth.browser.js.map +7 -0
- package/dist/marks.d.ts +62 -0
- package/dist/marks.d.ts.map +1 -0
- package/dist/marks.js +176 -0
- package/dist/marks.js.map +1 -0
- package/dist/render.d.ts +21 -0
- package/dist/render.d.ts.map +1 -0
- package/dist/render.js +117 -0
- package/dist/render.js.map +1 -0
- package/dist/spec.d.ts +56 -0
- package/dist/spec.d.ts.map +1 -0
- package/dist/spec.js +191 -0
- package/dist/spec.js.map +1 -0
- package/dist/theme.d.ts +82 -0
- package/dist/theme.d.ts.map +1 -0
- package/dist/theme.js +136 -0
- package/dist/theme.js.map +1 -0
- package/dist/transforms/basic.d.ts +35 -0
- package/dist/transforms/basic.d.ts.map +1 -0
- package/dist/transforms/basic.js +174 -0
- package/dist/transforms/basic.js.map +1 -0
- package/dist/transforms/group.d.ts +32 -0
- package/dist/transforms/group.d.ts.map +1 -0
- package/dist/transforms/group.js +419 -0
- package/dist/transforms/group.js.map +1 -0
- package/dist/transforms/interval.d.ts +24 -0
- package/dist/transforms/interval.d.ts.map +1 -0
- package/dist/transforms/interval.js +104 -0
- package/dist/transforms/interval.js.map +1 -0
- package/dist/transforms/map.d.ts +48 -0
- package/dist/transforms/map.d.ts.map +1 -0
- package/dist/transforms/map.js +192 -0
- package/dist/transforms/map.js.map +1 -0
- package/dist/transforms/select.d.ts +9 -0
- package/dist/transforms/select.d.ts.map +1 -0
- package/dist/transforms/select.js +50 -0
- package/dist/transforms/select.js.map +1 -0
- package/dist/transforms/stack.d.ts +23 -0
- package/dist/transforms/stack.d.ts.map +1 -0
- package/dist/transforms/stack.js +306 -0
- package/dist/transforms/stack.js.map +1 -0
- package/dist/types.d.ts +369 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +11 -0
- package/dist/types.js.map +1 -0
- package/package.json +70 -4
- package/README.md +0 -3
package/dist/spec.js
ADDED
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A declarative chart spec — the JSON that the editor edits and that
|
|
3
|
+
* `fromSpec()` turns into marks. It covers the common shapes (one mark over
|
|
4
|
+
* tidy rows, aggregated, stacked, smoothed, faceted, with insights); for
|
|
5
|
+
* anything else use the marks API directly.
|
|
6
|
+
*/
|
|
7
|
+
import { inferType, valueof } from "./channel.js";
|
|
8
|
+
import { areaY, barY, cell, dot, lineY, rectY } from "./marks.js";
|
|
9
|
+
import { auto } from "./auto.js";
|
|
10
|
+
import { binX, group, groupX } from "./transforms/group.js";
|
|
11
|
+
import { stackY } from "./transforms/stack.js";
|
|
12
|
+
import { windowY } from "./transforms/map.js";
|
|
13
|
+
/** Inspect tidy rows: field names and inferred types. */
|
|
14
|
+
export function inspectFields(input, sample = 500) {
|
|
15
|
+
const data = input;
|
|
16
|
+
const names = new Set();
|
|
17
|
+
for (const row of data.slice(0, sample))
|
|
18
|
+
for (const k of Object.keys(row))
|
|
19
|
+
names.add(k);
|
|
20
|
+
const out = [];
|
|
21
|
+
for (const name of names) {
|
|
22
|
+
const vals = valueof(data.slice(0, sample), name) ?? [];
|
|
23
|
+
const type = inferType(vals) ?? "ordinal";
|
|
24
|
+
const info = { name, type };
|
|
25
|
+
if (type === "ordinal") {
|
|
26
|
+
const seen = new Set();
|
|
27
|
+
const values = [];
|
|
28
|
+
for (const v of valueof(data, name) ?? []) {
|
|
29
|
+
if (v === null || v === undefined || seen.has(v))
|
|
30
|
+
continue;
|
|
31
|
+
seen.add(v);
|
|
32
|
+
values.push(v);
|
|
33
|
+
if (values.length >= 50)
|
|
34
|
+
break;
|
|
35
|
+
}
|
|
36
|
+
info.values = values;
|
|
37
|
+
}
|
|
38
|
+
out.push(info);
|
|
39
|
+
}
|
|
40
|
+
return out;
|
|
41
|
+
}
|
|
42
|
+
/** Build the marks for a spec. */
|
|
43
|
+
export function specMarks(input, spec) {
|
|
44
|
+
const data = input;
|
|
45
|
+
const { x, y, color, size, facet } = spec;
|
|
46
|
+
const fields = inspectFields(data, 200);
|
|
47
|
+
const typeOf = (f) => fields.find((d) => d.name === f)?.type;
|
|
48
|
+
const base = { x, y, fx: facet, curve: spec.curve, gradient: spec.gradient, insights: spec.insights, id: "main" };
|
|
49
|
+
if (spec.interval && spec.mark !== "histogram" && spec.mark !== "bar")
|
|
50
|
+
base.interval = spec.interval;
|
|
51
|
+
const colorKey = spec.mark === "line" || spec.mark === "dot" ? "stroke" : "fill";
|
|
52
|
+
if (color)
|
|
53
|
+
base[colorKey] = color;
|
|
54
|
+
if (spec.mark === "dot" && color)
|
|
55
|
+
base.fill = color;
|
|
56
|
+
if (size)
|
|
57
|
+
base.r = size;
|
|
58
|
+
if (spec.sort && spec.sort !== "none")
|
|
59
|
+
base.sort = { x: spec.sort };
|
|
60
|
+
const reduce = spec.reduce ?? undefined;
|
|
61
|
+
let opts = base;
|
|
62
|
+
switch (spec.mark) {
|
|
63
|
+
case "auto":
|
|
64
|
+
return auto(data, { x, y: reduce && y ? { value: y, reduce } : y, color, size, fx: facet, insights: spec.insights, curve: spec.curve, id: "main" });
|
|
65
|
+
case "histogram": {
|
|
66
|
+
const o = { ...base };
|
|
67
|
+
delete o.y;
|
|
68
|
+
return [rectY(data, binX({ y: "count", ...(spec.bins ? { thresholds: spec.bins } : {}), ...(spec.interval ? { interval: spec.interval } : {}) }, o))];
|
|
69
|
+
}
|
|
70
|
+
case "cell":
|
|
71
|
+
return [cell(data, group({ fill: reduce ?? "count" }, { ...base, fill: color ?? y, label: true }))];
|
|
72
|
+
default:
|
|
73
|
+
break;
|
|
74
|
+
}
|
|
75
|
+
// Aggregation for line/area/bar.
|
|
76
|
+
if (reduce || spec.mark === "bar") {
|
|
77
|
+
const r = reduce ?? (y ? "sum" : "count");
|
|
78
|
+
if (typeOf(x) === "ordinal")
|
|
79
|
+
opts = groupX({ y: r }, opts);
|
|
80
|
+
else
|
|
81
|
+
opts = binX({ y: r, ...(spec.interval ? { interval: spec.interval } : spec.bins ? { thresholds: spec.bins } : {}) }, opts);
|
|
82
|
+
}
|
|
83
|
+
if (spec.window && spec.window > 1)
|
|
84
|
+
opts = windowY({ k: spec.window, anchor: "middle" }, opts);
|
|
85
|
+
const stacked = spec.stack !== false && spec.stack !== undefined && Boolean(color);
|
|
86
|
+
switch (spec.mark) {
|
|
87
|
+
case "line":
|
|
88
|
+
return [lineY(data, opts)];
|
|
89
|
+
case "area": {
|
|
90
|
+
if (spec.stack === "normalize" || spec.stack === "center")
|
|
91
|
+
return [areaY(data, stackY({ offset: spec.stack }, opts))];
|
|
92
|
+
if (spec.stack === false && color)
|
|
93
|
+
return [areaY(data, { ...opts, y1: 0, y2: opts.y, fillOpacity: 0.25 })];
|
|
94
|
+
return [areaY(data, opts)];
|
|
95
|
+
}
|
|
96
|
+
case "bar": {
|
|
97
|
+
if (spec.stack === "normalize" || spec.stack === "center")
|
|
98
|
+
return [barY(data, stackY({ offset: spec.stack }, opts))];
|
|
99
|
+
if (!stacked && color)
|
|
100
|
+
return [barY(data, { ...opts, dodge: true })];
|
|
101
|
+
return [barY(data, opts)];
|
|
102
|
+
}
|
|
103
|
+
case "dot":
|
|
104
|
+
return [dot(data, opts)];
|
|
105
|
+
default:
|
|
106
|
+
return [lineY(data, opts)];
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
/** Build full plot options for a spec. */
|
|
110
|
+
export function fromSpec(data, spec) {
|
|
111
|
+
const o = {
|
|
112
|
+
marks: specMarks(data, spec),
|
|
113
|
+
theme: spec.theme,
|
|
114
|
+
title: spec.title,
|
|
115
|
+
subtitle: spec.subtitle,
|
|
116
|
+
x: { label: spec.xLabel === undefined ? undefined : spec.xLabel, zoom: spec.zoom },
|
|
117
|
+
y: { label: spec.yLabel === undefined ? undefined : spec.yLabel, percent: spec.stack === "normalize" },
|
|
118
|
+
color: { overrides: spec.colors },
|
|
119
|
+
};
|
|
120
|
+
if (spec.facet)
|
|
121
|
+
o.facet = { x: spec.facet };
|
|
122
|
+
return o;
|
|
123
|
+
}
|
|
124
|
+
const q = (v) => JSON.stringify(v);
|
|
125
|
+
/** Generate an `ip.plot({...})` snippet equivalent to the spec. */
|
|
126
|
+
export function specToCode(spec, dataName = "data") {
|
|
127
|
+
const { x, y, color, size, facet } = spec;
|
|
128
|
+
const ch = [];
|
|
129
|
+
if (x)
|
|
130
|
+
ch.push(`x: ${q(x)}`);
|
|
131
|
+
if (y && spec.mark !== "histogram")
|
|
132
|
+
ch.push(`y: ${q(y)}`);
|
|
133
|
+
const colorKey = spec.mark === "line" ? "stroke" : spec.mark === "auto" ? "color" : "fill";
|
|
134
|
+
if (color)
|
|
135
|
+
ch.push(`${colorKey}: ${q(color)}`);
|
|
136
|
+
if (size)
|
|
137
|
+
ch.push(spec.mark === "auto" ? `size: ${q(size)}` : `r: ${q(size)}`);
|
|
138
|
+
if (facet)
|
|
139
|
+
ch.push(`fx: ${q(facet)}`);
|
|
140
|
+
if (spec.curve)
|
|
141
|
+
ch.push(`curve: ${q(spec.curve)}`);
|
|
142
|
+
if (spec.gradient)
|
|
143
|
+
ch.push("gradient: true");
|
|
144
|
+
if (spec.interval && (spec.mark === "line" || spec.mark === "area" || spec.mark === "dot") && !spec.reduce)
|
|
145
|
+
ch.push(`interval: ${q(spec.interval)}`);
|
|
146
|
+
if (spec.sort && spec.sort !== "none")
|
|
147
|
+
ch.push(`sort: { x: ${q(spec.sort)} }`);
|
|
148
|
+
if (spec.stack === false && color && spec.mark === "bar")
|
|
149
|
+
ch.push("dodge: true");
|
|
150
|
+
let options = `{ ${ch.join(", ")} }`;
|
|
151
|
+
const reduce = spec.reduce ?? (spec.mark === "bar" ? (y ? "sum" : "count") : undefined);
|
|
152
|
+
let markCall;
|
|
153
|
+
switch (spec.mark) {
|
|
154
|
+
case "auto":
|
|
155
|
+
markCall = `ip.auto(${dataName}, { ${[x && `x: ${q(x)}`, y && (spec.reduce ? `y: { value: ${q(y)}, reduce: ${q(spec.reduce)} }` : `y: ${q(y)}`), color && `color: ${q(color)}`, size && `size: ${q(size)}`, facet && `fx: ${q(facet)}`].filter(Boolean).join(", ")} })`;
|
|
156
|
+
break;
|
|
157
|
+
case "histogram":
|
|
158
|
+
markCall = `ip.rectY(${dataName}, ip.binX({ y: "count"${spec.bins ? `, thresholds: ${spec.bins}` : ""}${spec.interval ? `, interval: ${q(spec.interval)}` : ""} }, ${options}))`;
|
|
159
|
+
break;
|
|
160
|
+
case "cell":
|
|
161
|
+
markCall = `ip.cell(${dataName}, ip.group({ fill: ${q(reduce ?? "count")} }, { x: ${q(x)}, y: ${q(y)}, fill: ${q(color ?? y)}, label: true }))`;
|
|
162
|
+
break;
|
|
163
|
+
default: {
|
|
164
|
+
if (reduce)
|
|
165
|
+
options = `ip.groupX({ y: ${q(reduce)} }, ${options})`;
|
|
166
|
+
if (spec.window && spec.window > 1)
|
|
167
|
+
options = `ip.windowY(${spec.window}, ${options})`;
|
|
168
|
+
if ((spec.stack === "normalize" || spec.stack === "center") && (spec.mark === "area" || spec.mark === "bar"))
|
|
169
|
+
options = `ip.stackY({ offset: ${q(spec.stack)} }, ${options})`;
|
|
170
|
+
const fn = { line: "lineY", area: "areaY", bar: "barY", dot: "dot" }[spec.mark] ?? "lineY";
|
|
171
|
+
markCall = `ip.${fn}(${dataName}, ${options})`;
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
const plotOpts = [`marks: [${markCall}]`];
|
|
175
|
+
if (spec.insights && Object.keys(spec.insights).length)
|
|
176
|
+
plotOpts.push(`insights: ${JSON.stringify(spec.insights)}`);
|
|
177
|
+
if (spec.facet)
|
|
178
|
+
plotOpts.push(`facet: { x: ${q(spec.facet)} }`);
|
|
179
|
+
if (spec.zoom)
|
|
180
|
+
plotOpts.push(`x: { zoom: true }`);
|
|
181
|
+
if (spec.stack === "normalize")
|
|
182
|
+
plotOpts.push(`y: { percent: true }`);
|
|
183
|
+
if (spec.colors && Object.keys(spec.colors).length)
|
|
184
|
+
plotOpts.push(`color: { overrides: ${JSON.stringify(spec.colors)} }`);
|
|
185
|
+
if (spec.theme && spec.theme !== "light")
|
|
186
|
+
plotOpts.push(`theme: ${q(spec.theme)}`);
|
|
187
|
+
if (spec.title)
|
|
188
|
+
plotOpts.push(`title: ${q(spec.title)}`);
|
|
189
|
+
return `ip.plot({\n ${plotOpts.join(",\n ")},\n})`;
|
|
190
|
+
}
|
|
191
|
+
//# sourceMappingURL=spec.js.map
|
package/dist/spec.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec.js","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA6C9C,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAAM,GAAG,GAAG;IAClE,MAAM,IAAI,GAAG,KAAuB,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;QAAE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAa,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClG,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;QAC1C,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;YAChC,MAAM,MAAM,GAAY,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,SAAS;gBAC3D,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACf,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE;oBAAE,MAAM;YACjC,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,SAAS,CAAC,KAAwB,EAAE,IAAe;IACjE,MAAM,IAAI,GAAG,KAAuB,CAAC;IACrC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;IACtE,MAAM,IAAI,GAA4B,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAC3I,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACrG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IACjF,IAAI,KAAK;QAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAClC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACpD,IAAI,IAAI;QAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACxB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;IACxC,IAAI,IAAI,GAA4B,IAAI,CAAC;IAEzC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACtJ,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC,CAAC,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACxJ,CAAC;QACD,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,OAAO,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtG;YACE,MAAM;IACV,CAAC;IACD,iCAAiC;IACjC,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;;YACtD,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAClI,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IACnF,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YACtH,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK;gBAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAiB,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3H,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YACrH,IAAI,CAAC,OAAO,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,KAAK;YACR,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3B;YACE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,QAAQ,CAAC,IAAuB,EAAE,IAAe;IAC/D,MAAM,CAAC,GAAgB;QACrB,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QAClF,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE;QACtG,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;KAClC,CAAC;IACF,IAAI,IAAI,CAAC,KAAK;QAAE,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC5C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE5C,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,QAAQ,GAAG,MAAM;IAC3D,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,EAAE,GAAa,EAAE,CAAC;IACxB,IAAI,CAAC;QAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3F,IAAI,KAAK;QAAE,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,IAAI;QAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/E,IAAI,KAAK;QAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,KAAK;QAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,QAAQ;QAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrJ,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjF,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxF,IAAI,QAAgB,CAAC;IACrB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,QAAQ,GAAG,WAAW,QAAQ,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,UAAU,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACxQ,MAAM;QACR,KAAK,WAAW;YACd,QAAQ,GAAG,YAAY,QAAQ,yBAAyB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,OAAO,IAAI,CAAC;YACjL,MAAM;QACR,KAAK,MAAM;YACT,QAAQ,GAAG,WAAW,QAAQ,sBAAsB,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,mBAAmB,CAAC;YAChJ,MAAM;QACR,OAAO,CAAC,CAAC,CAAC;YACR,IAAI,MAAM;gBAAE,OAAO,GAAG,kBAAkB,CAAC,CAAC,MAAM,CAAC,OAAO,OAAO,GAAG,CAAC;YACnE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,GAAG,cAAc,IAAI,CAAC,MAAM,KAAK,OAAO,GAAG,CAAC;YACvF,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,GAAG,uBAAuB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,OAAO,GAAG,CAAC;YAC9K,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;YAC3F,QAAQ,GAAG,MAAM,EAAE,IAAI,QAAQ,KAAK,OAAO,GAAG,CAAC;QACjD,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAa,CAAC,WAAW,QAAQ,GAAG,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;QAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpH,IAAI,IAAI,CAAC,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,IAAI,CAAC,IAAI;QAAE,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;QAAE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1H,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO;QAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnF,IAAI,IAAI,CAAC,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,gBAAgB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;AACvD,CAAC"}
|
package/dist/theme.d.ts
ADDED
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Themes. A theme is a small set of design tokens — surface, ink, grid, font,
|
|
3
|
+
* a categorical palette validated for its surface, sequential/diverging ramps,
|
|
4
|
+
* the insight colours and a few mark specs. The compiler reads nothing else
|
|
5
|
+
* for styling, so a chart is restyled completely by swapping the theme.
|
|
6
|
+
*
|
|
7
|
+
* ```ts
|
|
8
|
+
* plot({ theme: "dark", ... }) // built-in
|
|
9
|
+
* plot({ theme: { ...themes.dark, categorical: [...] } }) // one-off tweak
|
|
10
|
+
* defineTheme("brand", "light", { categorical: brandColors, font: "Inter" })
|
|
11
|
+
* plot({ theme: "brand", ... })
|
|
12
|
+
* ```
|
|
13
|
+
*
|
|
14
|
+
* The categorical palettes were checked with the dataviz validator (lightness
|
|
15
|
+
* band, chroma floor, adjacent-pair CVD separation, normal-vision floor,
|
|
16
|
+
* contrast vs. the surface) — assign them in order, never cycle.
|
|
17
|
+
*/
|
|
18
|
+
export interface ThemeInsightColors {
|
|
19
|
+
anomaly: string;
|
|
20
|
+
forecast: string;
|
|
21
|
+
changepoint: string;
|
|
22
|
+
trend: string;
|
|
23
|
+
outlier: string;
|
|
24
|
+
rare: string;
|
|
25
|
+
dominant: string;
|
|
26
|
+
band: string;
|
|
27
|
+
seriesOutlier: string;
|
|
28
|
+
positive: string;
|
|
29
|
+
negative: string;
|
|
30
|
+
}
|
|
31
|
+
export interface ThemeMarkSpecs {
|
|
32
|
+
/** Line width in px (2 by default: thin, round caps). */
|
|
33
|
+
lineWidth: number;
|
|
34
|
+
/** Opacity of a single (unstacked) area fill — a wash, not a block. */
|
|
35
|
+
areaOpacity: number;
|
|
36
|
+
/** Opacity of stacked area bands. */
|
|
37
|
+
stackOpacity: number;
|
|
38
|
+
/** Corner radius at a bar's data end. */
|
|
39
|
+
barRadius: number;
|
|
40
|
+
/** Maximum bar thickness in px. */
|
|
41
|
+
barMaxWidth: number;
|
|
42
|
+
/** Dot radius in px. */
|
|
43
|
+
dotRadius: number;
|
|
44
|
+
/** Width of the surface-coloured gap between touching marks (stack segments, bars, dot rings). */
|
|
45
|
+
gap: number;
|
|
46
|
+
}
|
|
47
|
+
export interface Theme {
|
|
48
|
+
name: string;
|
|
49
|
+
mode: "light" | "dark";
|
|
50
|
+
/** Chart surface. Used for gaps/rings even when the chart background is transparent. */
|
|
51
|
+
background: string;
|
|
52
|
+
/** Raised surface (tooltips, panels). */
|
|
53
|
+
surface: string;
|
|
54
|
+
/** Ink. */
|
|
55
|
+
text: string;
|
|
56
|
+
textSecondary: string;
|
|
57
|
+
textMuted: string;
|
|
58
|
+
/** Hairline grid and axis colours. */
|
|
59
|
+
grid: string;
|
|
60
|
+
axis: string;
|
|
61
|
+
/** Accent used for UI chrome (zoom handles, selection). */
|
|
62
|
+
accent: string;
|
|
63
|
+
font: string;
|
|
64
|
+
fontMono: string;
|
|
65
|
+
categorical: string[];
|
|
66
|
+
sequential: string[];
|
|
67
|
+
diverging: string[];
|
|
68
|
+
insight: ThemeInsightColors;
|
|
69
|
+
mark: ThemeMarkSpecs;
|
|
70
|
+
}
|
|
71
|
+
export declare const light: Theme;
|
|
72
|
+
export declare const dark: Theme;
|
|
73
|
+
/** Neutral high-contrast theme for print / reports. */
|
|
74
|
+
export declare const ink: Theme;
|
|
75
|
+
export declare const themes: Record<string, Theme>;
|
|
76
|
+
/** Register (or replace) a named theme derived from a base theme. */
|
|
77
|
+
export declare function defineTheme(name: string, base?: string | Theme, overrides?: Partial<Theme>): Theme;
|
|
78
|
+
/** Resolve a `theme` option: a name, a full theme, or a partial over `light`/`dark` (picked by `mode`). */
|
|
79
|
+
export declare function resolveTheme(theme: string | Partial<Theme> | undefined): Theme;
|
|
80
|
+
/** CSS custom properties for a theme (handy for the host page around a chart). */
|
|
81
|
+
export declare function themeToCSSVars(t: Theme, prefix?: string): Record<string, string>;
|
|
82
|
+
//# sourceMappingURL=theme.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,IAAI,EAAE,cAAc,CAAC;CACtB;AAKD,eAAO,MAAM,KAAK,EAAE,KA+BnB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,KA+BlB,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,GAAG,EAAE,KAYjB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAwB,CAAC;AAElE,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,KAAe,EAAE,SAAS,GAAE,OAAO,CAAC,KAAK,CAAM,GAAG,KAAK,CAK/G;AAED,2GAA2G;AAC3G,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,KAAK,CAS9E;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAehF"}
|
package/dist/theme.js
ADDED
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Themes. A theme is a small set of design tokens — surface, ink, grid, font,
|
|
3
|
+
* a categorical palette validated for its surface, sequential/diverging ramps,
|
|
4
|
+
* the insight colours and a few mark specs. The compiler reads nothing else
|
|
5
|
+
* for styling, so a chart is restyled completely by swapping the theme.
|
|
6
|
+
*
|
|
7
|
+
* ```ts
|
|
8
|
+
* plot({ theme: "dark", ... }) // built-in
|
|
9
|
+
* plot({ theme: { ...themes.dark, categorical: [...] } }) // one-off tweak
|
|
10
|
+
* defineTheme("brand", "light", { categorical: brandColors, font: "Inter" })
|
|
11
|
+
* plot({ theme: "brand", ... })
|
|
12
|
+
* ```
|
|
13
|
+
*
|
|
14
|
+
* The categorical palettes were checked with the dataviz validator (lightness
|
|
15
|
+
* band, chroma floor, adjacent-pair CVD separation, normal-vision floor,
|
|
16
|
+
* contrast vs. the surface) — assign them in order, never cycle.
|
|
17
|
+
*/
|
|
18
|
+
const FONT = '"Inter", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif';
|
|
19
|
+
const MONO = 'ui-monospace, "JetBrains Mono", "SF Mono", Menlo, Consolas, monospace';
|
|
20
|
+
export const light = {
|
|
21
|
+
name: "light",
|
|
22
|
+
mode: "light",
|
|
23
|
+
background: "#fbfbf9",
|
|
24
|
+
surface: "#ffffff",
|
|
25
|
+
text: "#1b1f24",
|
|
26
|
+
textSecondary: "#4f5560",
|
|
27
|
+
textMuted: "#8b919c",
|
|
28
|
+
grid: "#e6e6e1",
|
|
29
|
+
axis: "#c9c9c2",
|
|
30
|
+
accent: "#2a78d6",
|
|
31
|
+
font: FONT,
|
|
32
|
+
fontMono: MONO,
|
|
33
|
+
// Validated on #fbfbf9: adjacent CVD ΔE 9.1, normal-vision 19.6.
|
|
34
|
+
categorical: ["#2a78d6", "#eb6834", "#1baf7a", "#eda100", "#e87ba4", "#008300", "#4a3aa7", "#e34948"],
|
|
35
|
+
sequential: ["#cde2fb", "#9ec5f4", "#6da7ec", "#3987e5", "#256abf", "#184f95", "#0d366b"],
|
|
36
|
+
diverging: ["#c0392b", "#e8846f", "#f0efec", "#6da7ec", "#1c5cab"],
|
|
37
|
+
insight: {
|
|
38
|
+
anomaly: "#e34948",
|
|
39
|
+
forecast: "#4a3aa7",
|
|
40
|
+
changepoint: "#eb6834",
|
|
41
|
+
trend: "#8b919c",
|
|
42
|
+
outlier: "#e34948",
|
|
43
|
+
rare: "#8b919c",
|
|
44
|
+
dominant: "#eda100",
|
|
45
|
+
band: "#4a3aa7",
|
|
46
|
+
seriesOutlier: "#e34948",
|
|
47
|
+
positive: "#008300",
|
|
48
|
+
negative: "#2a78d6",
|
|
49
|
+
},
|
|
50
|
+
mark: { lineWidth: 2, areaOpacity: 0.12, stackOpacity: 0.9, barRadius: 4, barMaxWidth: 28, dotRadius: 4, gap: 2 },
|
|
51
|
+
};
|
|
52
|
+
export const dark = {
|
|
53
|
+
name: "dark",
|
|
54
|
+
mode: "dark",
|
|
55
|
+
background: "#0e1222",
|
|
56
|
+
surface: "#161b2e",
|
|
57
|
+
text: "#eef1f8",
|
|
58
|
+
textSecondary: "#aab3c8",
|
|
59
|
+
textMuted: "#6f7891",
|
|
60
|
+
grid: "#1f2640",
|
|
61
|
+
axis: "#2f375a",
|
|
62
|
+
accent: "#4a7df0",
|
|
63
|
+
font: FONT,
|
|
64
|
+
fontMono: MONO,
|
|
65
|
+
// Cool-first palette validated on #0e1222: adjacent CVD ΔE 14.3, normal-vision 21.0, all ≥ 3:1.
|
|
66
|
+
categorical: ["#4a7df0", "#0baa92", "#a86bfd", "#eb5f3d", "#0da2c6", "#b57400", "#c23a82", "#6a9a08"],
|
|
67
|
+
sequential: ["#13203f", "#1f3b7a", "#2b5ab4", "#3f7de8", "#5aa1f5", "#8ac6fb", "#c6e6ff"],
|
|
68
|
+
diverging: ["#eb5f3d", "#b06a5e", "#3a3f55", "#4a7df0", "#8ac6fb"],
|
|
69
|
+
insight: {
|
|
70
|
+
anomaly: "#ff5c7a",
|
|
71
|
+
forecast: "#a86bfd",
|
|
72
|
+
changepoint: "#f5b545",
|
|
73
|
+
trend: "#8b93a8",
|
|
74
|
+
outlier: "#ff5c7a",
|
|
75
|
+
rare: "#6f7891",
|
|
76
|
+
dominant: "#f5b545",
|
|
77
|
+
band: "#4a7df0",
|
|
78
|
+
seriesOutlier: "#ff5c7a",
|
|
79
|
+
positive: "#2ec27e",
|
|
80
|
+
negative: "#4a7df0",
|
|
81
|
+
},
|
|
82
|
+
mark: { lineWidth: 2, areaOpacity: 0.16, stackOpacity: 0.9, barRadius: 4, barMaxWidth: 28, dotRadius: 4, gap: 2 },
|
|
83
|
+
};
|
|
84
|
+
/** Neutral high-contrast theme for print / reports. */
|
|
85
|
+
export const ink = {
|
|
86
|
+
...light,
|
|
87
|
+
name: "ink",
|
|
88
|
+
background: "#ffffff",
|
|
89
|
+
surface: "#ffffff",
|
|
90
|
+
text: "#000000",
|
|
91
|
+
textSecondary: "#333333",
|
|
92
|
+
textMuted: "#777777",
|
|
93
|
+
grid: "#e2e2e2",
|
|
94
|
+
axis: "#000000",
|
|
95
|
+
accent: "#000000",
|
|
96
|
+
categorical: ["#1f3a93", "#c0392b", "#1e8449", "#b9770e", "#7d3c98", "#117a8b", "#5d6d7e", "#000000"],
|
|
97
|
+
};
|
|
98
|
+
export const themes = { light, dark, ink };
|
|
99
|
+
/** Register (or replace) a named theme derived from a base theme. */
|
|
100
|
+
export function defineTheme(name, base = "light", overrides = {}) {
|
|
101
|
+
const b = typeof base === "string" ? resolveTheme(base) : base;
|
|
102
|
+
const t = { ...b, ...overrides, name, insight: { ...b.insight, ...(overrides.insight ?? {}) }, mark: { ...b.mark, ...(overrides.mark ?? {}) } };
|
|
103
|
+
themes[name] = t;
|
|
104
|
+
return t;
|
|
105
|
+
}
|
|
106
|
+
/** Resolve a `theme` option: a name, a full theme, or a partial over `light`/`dark` (picked by `mode`). */
|
|
107
|
+
export function resolveTheme(theme) {
|
|
108
|
+
if (!theme)
|
|
109
|
+
return themes.light;
|
|
110
|
+
if (typeof theme === "string") {
|
|
111
|
+
const t = themes[theme];
|
|
112
|
+
if (!t)
|
|
113
|
+
throw new Error(`unknown theme "${theme}" (known: ${Object.keys(themes).join(", ")})`);
|
|
114
|
+
return t;
|
|
115
|
+
}
|
|
116
|
+
const base = themes[theme.name ?? ""] ?? (theme.mode === "dark" ? themes.dark : themes.light);
|
|
117
|
+
return { ...base, ...theme, name: theme.name ?? base.name, insight: { ...base.insight, ...(theme.insight ?? {}) }, mark: { ...base.mark, ...(theme.mark ?? {}) } };
|
|
118
|
+
}
|
|
119
|
+
/** CSS custom properties for a theme (handy for the host page around a chart). */
|
|
120
|
+
export function themeToCSSVars(t, prefix = "--ip") {
|
|
121
|
+
const vars = {
|
|
122
|
+
[`${prefix}-bg`]: t.background,
|
|
123
|
+
[`${prefix}-surface`]: t.surface,
|
|
124
|
+
[`${prefix}-text`]: t.text,
|
|
125
|
+
[`${prefix}-text-2`]: t.textSecondary,
|
|
126
|
+
[`${prefix}-text-3`]: t.textMuted,
|
|
127
|
+
[`${prefix}-grid`]: t.grid,
|
|
128
|
+
[`${prefix}-axis`]: t.axis,
|
|
129
|
+
[`${prefix}-accent`]: t.accent,
|
|
130
|
+
[`${prefix}-font`]: t.font,
|
|
131
|
+
[`${prefix}-mono`]: t.fontMono,
|
|
132
|
+
};
|
|
133
|
+
t.categorical.forEach((c, i) => (vars[`${prefix}-c${i + 1}`] = c));
|
|
134
|
+
return vars;
|
|
135
|
+
}
|
|
136
|
+
//# sourceMappingURL=theme.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/** Transform plumbing: composition, lazy columns, filter/sort/reverse. */
|
|
2
|
+
import type { ChannelSpec, ChannelValue, Facets, MarkOptions, Row, SortOrder, Transform, Value } from "../types.js";
|
|
3
|
+
/** Compose two transforms; `t1` runs first (it is the inner one). */
|
|
4
|
+
export declare function composeTransform<D>(t1: Transform<D> | undefined, t2: Transform<D> | undefined): Transform<D> | undefined;
|
|
5
|
+
/**
|
|
6
|
+
* A lazily-filled column: a channel whose values are set by a transform at
|
|
7
|
+
* run time (Plot's `Plot.column`). Returns `[channel, setter]`.
|
|
8
|
+
*/
|
|
9
|
+
export declare function column(label?: string): [ChannelSpec, (values: ArrayLike<Value>) => void];
|
|
10
|
+
/** True for `sort: {x: "y"}`-style scale-domain sorts (handled by scales, not data). */
|
|
11
|
+
export declare function isDomainSort(sort: unknown): sort is Record<string, unknown>;
|
|
12
|
+
/**
|
|
13
|
+
* Wrap `transform` around the basic `filter`/`sort`/`reverse` options and
|
|
14
|
+
* return a copy of `options` carrying the composed transform. An explicit
|
|
15
|
+
* `transform` in `options` overrides the basic ones (as in Plot).
|
|
16
|
+
*/
|
|
17
|
+
export declare function basic<D = Row>(options?: MarkOptions<D>, transform?: Transform<D>): MarkOptions<D>;
|
|
18
|
+
/** Explicit `filter` transform. */
|
|
19
|
+
export declare function filter<D = Row>(test: ChannelValue<D>, options?: MarkOptions<D>): MarkOptions<D>;
|
|
20
|
+
/** Explicit `sort` transform (data order, not scale domain). */
|
|
21
|
+
export declare function sort<D = Row>(order: SortOrder<D>, options?: MarkOptions<D>): MarkOptions<D>;
|
|
22
|
+
export declare function reverse<D = Row>(options?: MarkOptions<D>): MarkOptions<D>;
|
|
23
|
+
/** Shuffle with a seeded LCG for reproducibility. */
|
|
24
|
+
export declare function shuffle<D = Row>({ seed }?: {
|
|
25
|
+
seed?: number;
|
|
26
|
+
}, options?: MarkOptions<D>): MarkOptions<D>;
|
|
27
|
+
/** Group facet indices by series (the `z` ?? `fill` ?? `stroke` channel). */
|
|
28
|
+
export declare function seriesOf<D>(data: readonly D[], I: readonly number[], options: MarkOptions<D>): number[][];
|
|
29
|
+
/** The series channel: `z`, else `fill` or `stroke` when those are data channels. */
|
|
30
|
+
export declare function zOf<D>(options: MarkOptions<D>): ChannelValue<D> | undefined;
|
|
31
|
+
/** True when a `fill`/`stroke` option refers to data rather than a literal color. */
|
|
32
|
+
export declare function isDataChannel(v: unknown): boolean;
|
|
33
|
+
/** Helper for transforms that produce one output column per facet index. */
|
|
34
|
+
export declare function facetAll(n: number): Facets;
|
|
35
|
+
//# sourceMappingURL=basic.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../src/transforms/basic.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAmB,KAAK,EAAE,MAAM,aAAa,CAAC;AAGrI,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAOxH;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAUxF;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ3E;AAwCD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAarG;AAED,mCAAmC;AACnC,wBAAgB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAEnG;AAED,gEAAgE;AAChE,wBAAgB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAE/F;AAED,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAE7E;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,IAAS,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,EAAE,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAgBpH;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,EAAE,CAazG;AAED,qFAAqF;AACrF,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAK3E;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAMjD;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C"}
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
/** Transform plumbing: composition, lazy columns, filter/sort/reverse. */
|
|
2
|
+
import { ascending, descending, isColor, valueof } from "../channel.js";
|
|
3
|
+
/** Compose two transforms; `t1` runs first (it is the inner one). */
|
|
4
|
+
export function composeTransform(t1, t2) {
|
|
5
|
+
if (!t1)
|
|
6
|
+
return t2;
|
|
7
|
+
if (!t2)
|
|
8
|
+
return t1;
|
|
9
|
+
return (data, facets) => {
|
|
10
|
+
const r = t1(data, facets);
|
|
11
|
+
return t2(r.data, r.facets);
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* A lazily-filled column: a channel whose values are set by a transform at
|
|
16
|
+
* run time (Plot's `Plot.column`). Returns `[channel, setter]`.
|
|
17
|
+
*/
|
|
18
|
+
export function column(label) {
|
|
19
|
+
let values;
|
|
20
|
+
const spec = {
|
|
21
|
+
value: (_d, i) => {
|
|
22
|
+
if (!values)
|
|
23
|
+
throw new Error("isopleth: column read before its transform ran");
|
|
24
|
+
return values[i];
|
|
25
|
+
},
|
|
26
|
+
label,
|
|
27
|
+
};
|
|
28
|
+
return [spec, (v) => (values = v)];
|
|
29
|
+
}
|
|
30
|
+
/** True for `sort: {x: "y"}`-style scale-domain sorts (handled by scales, not data). */
|
|
31
|
+
export function isDomainSort(sort) {
|
|
32
|
+
return (typeof sort === "object" &&
|
|
33
|
+
sort !== null &&
|
|
34
|
+
typeof sort !== "function" &&
|
|
35
|
+
sort.value === undefined &&
|
|
36
|
+
sort.channel === undefined);
|
|
37
|
+
}
|
|
38
|
+
function filterTransform(test) {
|
|
39
|
+
return (data, facets) => {
|
|
40
|
+
const T = valueof(data, test);
|
|
41
|
+
if (!T)
|
|
42
|
+
return { data, facets };
|
|
43
|
+
return { data, facets: facets.map((I) => I.filter((i) => Boolean(T[i]))) };
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
function sortTransform(sort) {
|
|
47
|
+
if (typeof sort === "function" && sort.length !== 1) {
|
|
48
|
+
const cmp = sort;
|
|
49
|
+
return (data, facets) => ({ data, facets: facets.map((I) => I.slice().sort((i, j) => cmp(data[i], data[j]))) });
|
|
50
|
+
}
|
|
51
|
+
let value;
|
|
52
|
+
let order = "ascending";
|
|
53
|
+
if (typeof sort === "string" || typeof sort === "function")
|
|
54
|
+
value = sort;
|
|
55
|
+
else {
|
|
56
|
+
const s = sort;
|
|
57
|
+
let ch = s.channel ?? "";
|
|
58
|
+
if (ch.startsWith("-")) {
|
|
59
|
+
ch = ch.slice(1);
|
|
60
|
+
order = "descending";
|
|
61
|
+
}
|
|
62
|
+
value = ch;
|
|
63
|
+
if (s.order)
|
|
64
|
+
order = s.order;
|
|
65
|
+
}
|
|
66
|
+
return (data, facets) => {
|
|
67
|
+
const V = valueof(data, value);
|
|
68
|
+
if (!V)
|
|
69
|
+
return { data, facets };
|
|
70
|
+
const cmp = order === "descending" ? descending : ascending;
|
|
71
|
+
return { data, facets: facets.map((I) => I.slice().sort((i, j) => cmp(V[i], V[j]))) };
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
function reverseTransform(data, facets) {
|
|
75
|
+
return { data, facets: facets.map((I) => I.slice().reverse()) };
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Wrap `transform` around the basic `filter`/`sort`/`reverse` options and
|
|
79
|
+
* return a copy of `options` carrying the composed transform. An explicit
|
|
80
|
+
* `transform` in `options` overrides the basic ones (as in Plot).
|
|
81
|
+
*/
|
|
82
|
+
export function basic(options = {}, transform) {
|
|
83
|
+
const { filter, sort, reverse, transform: t0, ...rest } = options;
|
|
84
|
+
let t1 = t0;
|
|
85
|
+
if (t1 === undefined) {
|
|
86
|
+
if (filter !== undefined && filter !== null)
|
|
87
|
+
t1 = filterTransform(filter);
|
|
88
|
+
if (sort !== undefined && sort !== null && !isDomainSort(sort))
|
|
89
|
+
t1 = composeTransform(t1, sortTransform(sort));
|
|
90
|
+
if (reverse)
|
|
91
|
+
t1 = composeTransform(t1, reverseTransform);
|
|
92
|
+
}
|
|
93
|
+
const out = { ...rest };
|
|
94
|
+
if (sort !== undefined && isDomainSort(sort))
|
|
95
|
+
out.sort = sort;
|
|
96
|
+
const composed = composeTransform(t1, transform);
|
|
97
|
+
if (composed)
|
|
98
|
+
out.transform = composed;
|
|
99
|
+
return out;
|
|
100
|
+
}
|
|
101
|
+
/** Explicit `filter` transform. */
|
|
102
|
+
export function filter(test, options = {}) {
|
|
103
|
+
return basic(options, filterTransform(test));
|
|
104
|
+
}
|
|
105
|
+
/** Explicit `sort` transform (data order, not scale domain). */
|
|
106
|
+
export function sort(order, options = {}) {
|
|
107
|
+
return basic(options, sortTransform(order));
|
|
108
|
+
}
|
|
109
|
+
export function reverse(options = {}) {
|
|
110
|
+
return basic(options, reverseTransform);
|
|
111
|
+
}
|
|
112
|
+
/** Shuffle with a seeded LCG for reproducibility. */
|
|
113
|
+
export function shuffle({ seed = 42 } = {}, options = {}) {
|
|
114
|
+
return basic(options, (data, facets) => {
|
|
115
|
+
let s = seed >>> 0;
|
|
116
|
+
const rnd = () => ((s = (s * 1664525 + 1013904223) >>> 0) / 4294967296);
|
|
117
|
+
return {
|
|
118
|
+
data,
|
|
119
|
+
facets: facets.map((I) => {
|
|
120
|
+
const J = I.slice();
|
|
121
|
+
for (let i = J.length - 1; i > 0; i--) {
|
|
122
|
+
const j = Math.floor(rnd() * (i + 1));
|
|
123
|
+
[J[i], J[j]] = [J[j], J[i]];
|
|
124
|
+
}
|
|
125
|
+
return J;
|
|
126
|
+
}),
|
|
127
|
+
};
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
/** Group facet indices by series (the `z` ?? `fill` ?? `stroke` channel). */
|
|
131
|
+
export function seriesOf(data, I, options) {
|
|
132
|
+
const zChannel = zOf(options);
|
|
133
|
+
if (zChannel === undefined)
|
|
134
|
+
return [I.slice()];
|
|
135
|
+
const Z = valueof(data, zChannel);
|
|
136
|
+
if (!Z)
|
|
137
|
+
return [I.slice()];
|
|
138
|
+
const groups = new Map();
|
|
139
|
+
for (const i of I) {
|
|
140
|
+
const k = Z[i] instanceof Date ? +Z[i] : Z[i];
|
|
141
|
+
let g = groups.get(k);
|
|
142
|
+
if (!g)
|
|
143
|
+
groups.set(k, (g = []));
|
|
144
|
+
g.push(i);
|
|
145
|
+
}
|
|
146
|
+
return [...groups.values()];
|
|
147
|
+
}
|
|
148
|
+
/** The series channel: `z`, else `fill` or `stroke` when those are data channels. */
|
|
149
|
+
export function zOf(options) {
|
|
150
|
+
if (options.z !== undefined && options.z !== null)
|
|
151
|
+
return options.z;
|
|
152
|
+
if (isDataChannel(options.fill))
|
|
153
|
+
return options.fill;
|
|
154
|
+
if (isDataChannel(options.stroke))
|
|
155
|
+
return options.stroke;
|
|
156
|
+
return undefined;
|
|
157
|
+
}
|
|
158
|
+
/** True when a `fill`/`stroke` option refers to data rather than a literal color. */
|
|
159
|
+
export function isDataChannel(v) {
|
|
160
|
+
if (v === undefined || v === null)
|
|
161
|
+
return false;
|
|
162
|
+
if (typeof v === "function" || Array.isArray(v) || ArrayBuffer.isView(v))
|
|
163
|
+
return true;
|
|
164
|
+
if (typeof v === "string")
|
|
165
|
+
return !isColor(v);
|
|
166
|
+
if (typeof v === "object")
|
|
167
|
+
return "value" in v;
|
|
168
|
+
return false;
|
|
169
|
+
}
|
|
170
|
+
/** Helper for transforms that produce one output column per facet index. */
|
|
171
|
+
export function facetAll(n) {
|
|
172
|
+
return [Array.from({ length: n }, (_, i) => i)];
|
|
173
|
+
}
|
|
174
|
+
//# sourceMappingURL=basic.js.map
|