@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.
Files changed (129) hide show
  1. package/dist/auto.d.ts +61 -0
  2. package/dist/auto.d.ts.map +1 -0
  3. package/dist/auto.js +213 -0
  4. package/dist/auto.js.map +1 -0
  5. package/dist/backend/index.d.ts +24 -0
  6. package/dist/backend/index.d.ts.map +1 -0
  7. package/dist/backend/index.js +42 -0
  8. package/dist/backend/index.js.map +1 -0
  9. package/dist/backend/js/index.d.ts +7 -0
  10. package/dist/backend/js/index.d.ts.map +1 -0
  11. package/dist/backend/js/index.js +33 -0
  12. package/dist/backend/js/index.js.map +1 -0
  13. package/dist/backend/js/insights.d.ts +30 -0
  14. package/dist/backend/js/insights.d.ts.map +1 -0
  15. package/dist/backend/js/insights.js +663 -0
  16. package/dist/backend/js/insights.js.map +1 -0
  17. package/dist/backend/js/kernels.d.ts +22 -0
  18. package/dist/backend/js/kernels.d.ts.map +1 -0
  19. package/dist/backend/js/kernels.js +562 -0
  20. package/dist/backend/js/kernels.js.map +1 -0
  21. package/dist/backend/js/stats.d.ts +26 -0
  22. package/dist/backend/js/stats.d.ts.map +1 -0
  23. package/dist/backend/js/stats.js +237 -0
  24. package/dist/backend/js/stats.js.map +1 -0
  25. package/dist/backend/types.d.ts +139 -0
  26. package/dist/backend/types.d.ts.map +1 -0
  27. package/dist/backend/types.js +12 -0
  28. package/dist/backend/types.js.map +1 -0
  29. package/dist/backend/wasm-wrap.d.ts +9 -0
  30. package/dist/backend/wasm-wrap.d.ts.map +1 -0
  31. package/dist/backend/wasm-wrap.js +52 -0
  32. package/dist/backend/wasm-wrap.js.map +1 -0
  33. package/dist/backend/wasm.d.ts +30 -0
  34. package/dist/backend/wasm.d.ts.map +1 -0
  35. package/dist/backend/wasm.js +29 -0
  36. package/dist/backend/wasm.js.map +1 -0
  37. package/dist/channel.d.ts +41 -0
  38. package/dist/channel.d.ts.map +1 -0
  39. package/dist/channel.js +205 -0
  40. package/dist/channel.js.map +1 -0
  41. package/dist/chart.d.ts +70 -0
  42. package/dist/chart.d.ts.map +1 -0
  43. package/dist/chart.js +68 -0
  44. package/dist/chart.js.map +1 -0
  45. package/dist/compile/index.d.ts +28 -0
  46. package/dist/compile/index.d.ts.map +1 -0
  47. package/dist/compile/index.js +391 -0
  48. package/dist/compile/index.js.map +1 -0
  49. package/dist/compile/palette.d.ts +41 -0
  50. package/dist/compile/palette.d.ts.map +1 -0
  51. package/dist/compile/palette.js +102 -0
  52. package/dist/compile/palette.js.map +1 -0
  53. package/dist/compile/resolve.d.ts +41 -0
  54. package/dist/compile/resolve.d.ts.map +1 -0
  55. package/dist/compile/resolve.js +155 -0
  56. package/dist/compile/resolve.js.map +1 -0
  57. package/dist/compile/scales.d.ts +49 -0
  58. package/dist/compile/scales.d.ts.map +1 -0
  59. package/dist/compile/scales.js +348 -0
  60. package/dist/compile/scales.js.map +1 -0
  61. package/dist/compile/series.d.ts +65 -0
  62. package/dist/compile/series.d.ts.map +1 -0
  63. package/dist/compile/series.js +948 -0
  64. package/dist/compile/series.js.map +1 -0
  65. package/dist/editor/index.d.ts +46 -0
  66. package/dist/editor/index.d.ts.map +1 -0
  67. package/dist/editor/index.js +342 -0
  68. package/dist/editor/index.js.map +1 -0
  69. package/dist/index.d.ts +47 -0
  70. package/dist/index.d.ts.map +1 -0
  71. package/dist/index.js +41 -0
  72. package/dist/index.js.map +1 -0
  73. package/dist/insights/index.d.ts +21 -0
  74. package/dist/insights/index.d.ts.map +1 -0
  75. package/dist/insights/index.js +461 -0
  76. package/dist/insights/index.js.map +1 -0
  77. package/dist/interval.d.ts +19 -0
  78. package/dist/interval.d.ts.map +1 -0
  79. package/dist/interval.js +166 -0
  80. package/dist/interval.js.map +1 -0
  81. package/dist/isopleth.browser.js +44 -0
  82. package/dist/isopleth.browser.js.LEGAL.txt +28 -0
  83. package/dist/isopleth.browser.js.map +7 -0
  84. package/dist/marks.d.ts +62 -0
  85. package/dist/marks.d.ts.map +1 -0
  86. package/dist/marks.js +176 -0
  87. package/dist/marks.js.map +1 -0
  88. package/dist/render.d.ts +21 -0
  89. package/dist/render.d.ts.map +1 -0
  90. package/dist/render.js +117 -0
  91. package/dist/render.js.map +1 -0
  92. package/dist/spec.d.ts +56 -0
  93. package/dist/spec.d.ts.map +1 -0
  94. package/dist/spec.js +191 -0
  95. package/dist/spec.js.map +1 -0
  96. package/dist/theme.d.ts +82 -0
  97. package/dist/theme.d.ts.map +1 -0
  98. package/dist/theme.js +136 -0
  99. package/dist/theme.js.map +1 -0
  100. package/dist/transforms/basic.d.ts +35 -0
  101. package/dist/transforms/basic.d.ts.map +1 -0
  102. package/dist/transforms/basic.js +174 -0
  103. package/dist/transforms/basic.js.map +1 -0
  104. package/dist/transforms/group.d.ts +32 -0
  105. package/dist/transforms/group.d.ts.map +1 -0
  106. package/dist/transforms/group.js +419 -0
  107. package/dist/transforms/group.js.map +1 -0
  108. package/dist/transforms/interval.d.ts +24 -0
  109. package/dist/transforms/interval.d.ts.map +1 -0
  110. package/dist/transforms/interval.js +104 -0
  111. package/dist/transforms/interval.js.map +1 -0
  112. package/dist/transforms/map.d.ts +48 -0
  113. package/dist/transforms/map.d.ts.map +1 -0
  114. package/dist/transforms/map.js +192 -0
  115. package/dist/transforms/map.js.map +1 -0
  116. package/dist/transforms/select.d.ts +9 -0
  117. package/dist/transforms/select.d.ts.map +1 -0
  118. package/dist/transforms/select.js +50 -0
  119. package/dist/transforms/select.js.map +1 -0
  120. package/dist/transforms/stack.d.ts +23 -0
  121. package/dist/transforms/stack.d.ts.map +1 -0
  122. package/dist/transforms/stack.js +306 -0
  123. package/dist/transforms/stack.js.map +1 -0
  124. package/dist/types.d.ts +369 -0
  125. package/dist/types.d.ts.map +1 -0
  126. package/dist/types.js +11 -0
  127. package/dist/types.js.map +1 -0
  128. package/package.json +70 -4
  129. package/README.md +0 -3
@@ -0,0 +1,29 @@
1
+ /**
2
+ * WebAssembly backend: wraps the wasm-bindgen output of `crates/isopleth-wasm`
3
+ * (published as `@danielmcsheehy/isopleth-wasm`) behind the `Backend` interface.
4
+ *
5
+ * ```ts
6
+ * import * as ip from "@danielmcsheehy/isopleth";
7
+ * import { loadWasm } from "@danielmcsheehy/isopleth/wasm";
8
+ * await ip.init(loadWasm());
9
+ * ```
10
+ *
11
+ * The import is dynamic so that apps that never call `loadWasm()` do not ship
12
+ * the `.wasm` file.
13
+ */
14
+ import * as bundled from "@danielmcsheehy/isopleth-wasm";
15
+ import { wrapWasm } from "./wasm-wrap.js";
16
+ export { wrapWasm };
17
+ /**
18
+ * Load and initialise the WebAssembly backend. Importing `@danielmcsheehy/isopleth/wasm`
19
+ * statically pulls in `@danielmcsheehy/isopleth-wasm`, so keep the import behind a dynamic
20
+ * `import("@danielmcsheehy/isopleth/wasm")` if you want it code-split.
21
+ */
22
+ export async function loadWasm(options = {}) {
23
+ const mod = options.bindings ?? bundled;
24
+ if (typeof mod.default === "function") {
25
+ await mod.default(options.module === undefined ? undefined : { module_or_path: options.module });
26
+ }
27
+ return wrapWasm(mod);
28
+ }
29
+ //# sourceMappingURL=wasm.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wasm.js","sourceRoot":"","sources":["../../src/backend/wasm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,OAAO,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAmB,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,CAAC;AAUpB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAA2B,EAAE;IAC1D,MAAM,GAAG,GAAe,OAAO,CAAC,QAAQ,IAAK,OAAiC,CAAC;IAC/E,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}
@@ -0,0 +1,41 @@
1
+ /** Channel resolution and type inference. */
2
+ import type { ChannelSpec, ChannelValue, Row, ScaleType, Value } from "./types.js";
3
+ /** Use the datum itself as the channel value (Plot's `Plot.identity`). */
4
+ export declare const identity: unique symbol;
5
+ /** Use the datum's index as the channel value (Plot's `Plot.indexOf`). */
6
+ export declare const indexOf: unique symbol;
7
+ /** True when `v` is a CSS color string (so `fill: "red"` is a constant, not a field). */
8
+ export declare function isColor(v: unknown): v is string;
9
+ export declare function isGradient(v: unknown): v is {
10
+ type: string;
11
+ colorStops: unknown[];
12
+ };
13
+ export declare function isChannelSpec(v: unknown): v is ChannelSpec;
14
+ /**
15
+ * Resolve a channel definition against `data`. Returns `undefined` for an
16
+ * undefined channel, otherwise an array of the same length as `data`.
17
+ */
18
+ export declare function valueof<D = Row>(data: readonly D[], value: ChannelValue<D> | typeof identity | typeof indexOf | undefined): Value[] | undefined;
19
+ /** Field name/label for a channel definition, if it has an obvious one. */
20
+ export declare function labelof(value: unknown, fallback?: string): string | undefined;
21
+ /** A human label for a channel: its field name unless that is an internal or generic channel name, else `prev`. */
22
+ export declare function carryLabel(value: unknown, prev: string | undefined, channel: string): string | undefined;
23
+ /** Infer the scale type from the first non-missing value. */
24
+ export declare function inferType(values: readonly Value[] | undefined): ScaleType | undefined;
25
+ export declare function isMissing(v: Value): boolean;
26
+ /** Convert continuous values to numbers (dates → epoch ms); missing → NaN. */
27
+ export declare function toNumbers(values: readonly Value[]): Float64Array;
28
+ export declare function toNumber(v: Value): number;
29
+ /** Key used to group ordinal values (`Date` → ms, else primitive). */
30
+ export declare function keyof(v: Value): string | number | boolean | null;
31
+ /** Encode values as integer codes over their distinct (first-seen) order. */
32
+ export declare function encode(values: readonly Value[], domain?: readonly Value[]): {
33
+ codes: Int32Array;
34
+ domain: Value[];
35
+ };
36
+ /** Ascending comparator for mixed values (numbers, dates, strings). */
37
+ export declare function ascending(a: Value, b: Value): number;
38
+ export declare function descending(a: Value, b: Value): number;
39
+ /** Format a value for labels/tooltips/summaries. */
40
+ export declare function formatValue(v: Value, type?: ScaleType): string;
41
+ //# sourceMappingURL=channel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnF,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,EAAE,OAAO,MAAoC,CAAC;AACnE,0EAA0E;AAC1E,eAAO,MAAM,OAAO,EAAE,OAAO,MAAmC,CAAC;AAsBjE,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAI/C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,EAAE,CAAA;CAAE,CAEnF;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D;AAMD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,GAAG,OAAO,OAAO,GAAG,SAAS,GAAG,KAAK,EAAE,GAAG,SAAS,CAa/I;AAED,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7E;AAED,mHAAmH;AACnH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIxG;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAarF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAE3C;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,YAAY,CAIhE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAMzC;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAKhE;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAgClH;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAQpD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAErD;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAe9D"}
@@ -0,0 +1,205 @@
1
+ /** Channel resolution and type inference. */
2
+ /** Use the datum itself as the channel value (Plot's `Plot.identity`). */
3
+ export const identity = Symbol("isopleth.identity");
4
+ /** Use the datum's index as the channel value (Plot's `Plot.indexOf`). */
5
+ export const indexOf = Symbol("isopleth.indexOf");
6
+ const NAMED_COLORS = new Set([
7
+ "black", "silver", "gray", "grey", "white", "maroon", "red", "purple", "fuchsia", "green", "lime", "olive", "yellow", "navy",
8
+ "blue", "teal", "aqua", "orange", "aliceblue", "antiquewhite", "aquamarine", "azure", "beige", "bisque", "blanchedalmond",
9
+ "blueviolet", "brown", "burlywood", "cadetblue", "chartreuse", "chocolate", "coral", "cornflowerblue", "cornsilk", "crimson",
10
+ "cyan", "darkblue", "darkcyan", "darkgoldenrod", "darkgray", "darkgreen", "darkgrey", "darkkhaki", "darkmagenta",
11
+ "darkolivegreen", "darkorange", "darkorchid", "darkred", "darksalmon", "darkseagreen", "darkslateblue", "darkslategray",
12
+ "darkslategrey", "darkturquoise", "darkviolet", "deeppink", "deepskyblue", "dimgray", "dimgrey", "dodgerblue", "firebrick",
13
+ "floralwhite", "forestgreen", "gainsboro", "ghostwhite", "gold", "goldenrod", "greenyellow", "honeydew", "hotpink",
14
+ "indianred", "indigo", "ivory", "khaki", "lavender", "lavenderblush", "lawngreen", "lemonchiffon", "lightblue",
15
+ "lightcoral", "lightcyan", "lightgoldenrodyellow", "lightgray", "lightgreen", "lightgrey", "lightpink", "lightsalmon",
16
+ "lightseagreen", "lightskyblue", "lightslategray", "lightslategrey", "lightsteelblue", "lightyellow", "limegreen", "linen",
17
+ "magenta", "mediumaquamarine", "mediumblue", "mediumorchid", "mediumpurple", "mediumseagreen", "mediumslateblue",
18
+ "mediumspringgreen", "mediumturquoise", "mediumvioletred", "midnightblue", "mintcream", "mistyrose", "moccasin",
19
+ "navajowhite", "oldlace", "olivedrab", "orangered", "orchid", "palegoldenrod", "palegreen", "paleturquoise",
20
+ "palevioletred", "papayawhip", "peachpuff", "peru", "pink", "plum", "powderblue", "rosybrown", "royalblue", "saddlebrown",
21
+ "salmon", "sandybrown", "seagreen", "seashell", "sienna", "skyblue", "slateblue", "slategray", "slategrey", "snow",
22
+ "springgreen", "steelblue", "tan", "thistle", "tomato", "turquoise", "violet", "wheat", "whitesmoke", "yellowgreen",
23
+ "rebeccapurple", "transparent", "currentcolor", "none",
24
+ ]);
25
+ /** True when `v` is a CSS color string (so `fill: "red"` is a constant, not a field). */
26
+ export function isColor(v) {
27
+ if (typeof v !== "string")
28
+ return false;
29
+ const s = v.trim().toLowerCase();
30
+ return s.startsWith("#") || s.startsWith("rgb") || s.startsWith("hsl") || s.startsWith("var(") || NAMED_COLORS.has(s);
31
+ }
32
+ export function isGradient(v) {
33
+ return typeof v === "object" && v !== null && "colorStops" in v;
34
+ }
35
+ export function isChannelSpec(v) {
36
+ return typeof v === "object" && v !== null && !Array.isArray(v) && !(v instanceof Date) && !ArrayBuffer.isView(v) && "value" in v;
37
+ }
38
+ function isArrayLike(v) {
39
+ return (Array.isArray(v) || ArrayBuffer.isView(v)) && typeof v !== "string";
40
+ }
41
+ /**
42
+ * Resolve a channel definition against `data`. Returns `undefined` for an
43
+ * undefined channel, otherwise an array of the same length as `data`.
44
+ */
45
+ export function valueof(data, value) {
46
+ if (value === undefined || value === null)
47
+ return undefined;
48
+ if (value === identity)
49
+ return data;
50
+ if (value === indexOf)
51
+ return data.map((_, i) => i);
52
+ if (isChannelSpec(value))
53
+ return valueof(data, value.value);
54
+ if (typeof value === "function")
55
+ return data.map((d, i) => value(d, i, data));
56
+ if (typeof value === "string")
57
+ return data.map((d) => d?.[value]);
58
+ if (isArrayLike(value)) {
59
+ if (value.length !== data.length)
60
+ throw new Error(`channel array length ${value.length} does not match data length ${data.length}`);
61
+ return Array.from(value);
62
+ }
63
+ // Constant (number, Date, boolean).
64
+ return data.map(() => value);
65
+ }
66
+ /** Field name/label for a channel definition, if it has an obvious one. */
67
+ export function labelof(value, fallback) {
68
+ if (typeof value === "string")
69
+ return value;
70
+ if (isChannelSpec(value))
71
+ return value.label ?? labelof(value.value);
72
+ return fallback;
73
+ }
74
+ /** A human label for a channel: its field name unless that is an internal or generic channel name, else `prev`. */
75
+ export function carryLabel(value, prev, channel) {
76
+ const l = labelof(value);
77
+ if (l && !l.startsWith("__") && l !== channel && !/^(x|y|x1|x2|y1|y2|z|fill|stroke)$/.test(l))
78
+ return l;
79
+ return prev;
80
+ }
81
+ /** Infer the scale type from the first non-missing value. */
82
+ export function inferType(values) {
83
+ if (!values)
84
+ return undefined;
85
+ for (const v of values) {
86
+ if (v === null || v === undefined)
87
+ continue;
88
+ if (typeof v === "number") {
89
+ if (Number.isNaN(v))
90
+ continue;
91
+ return "quantitative";
92
+ }
93
+ if (v instanceof Date)
94
+ return Number.isNaN(+v) ? undefined : "temporal";
95
+ if (typeof v === "string" || typeof v === "boolean")
96
+ return "ordinal";
97
+ if (typeof v === "bigint")
98
+ return "quantitative";
99
+ }
100
+ return undefined;
101
+ }
102
+ export function isMissing(v) {
103
+ return v === null || v === undefined || (typeof v === "number" && Number.isNaN(v)) || (v instanceof Date && Number.isNaN(+v));
104
+ }
105
+ /** Convert continuous values to numbers (dates → epoch ms); missing → NaN. */
106
+ export function toNumbers(values) {
107
+ const out = new Float64Array(values.length);
108
+ for (let i = 0; i < values.length; i++)
109
+ out[i] = toNumber(values[i]);
110
+ return out;
111
+ }
112
+ export function toNumber(v) {
113
+ if (typeof v === "number")
114
+ return v;
115
+ if (v instanceof Date)
116
+ return +v;
117
+ if (typeof v === "bigint")
118
+ return Number(v);
119
+ if (typeof v === "string" && v !== "" && !Number.isNaN(Number(v)))
120
+ return Number(v);
121
+ return NaN;
122
+ }
123
+ /** Key used to group ordinal values (`Date` → ms, else primitive). */
124
+ export function keyof(v) {
125
+ if (v === undefined || v === null)
126
+ return null;
127
+ if (v instanceof Date)
128
+ return +v;
129
+ if (typeof v === "number" && Number.isNaN(v))
130
+ return null;
131
+ return v;
132
+ }
133
+ /** Encode values as integer codes over their distinct (first-seen) order. */
134
+ export function encode(values, domain) {
135
+ const index = new Map();
136
+ const dom = [];
137
+ if (domain) {
138
+ for (const d of domain) {
139
+ const k = keyof(d);
140
+ if (k !== null && !index.has(k)) {
141
+ index.set(k, dom.length);
142
+ dom.push(d);
143
+ }
144
+ }
145
+ }
146
+ const codes = new Int32Array(values.length);
147
+ for (let i = 0; i < values.length; i++) {
148
+ const k = keyof(values[i]);
149
+ if (k === null) {
150
+ codes[i] = -1;
151
+ continue;
152
+ }
153
+ let c = index.get(k);
154
+ if (c === undefined) {
155
+ if (domain) {
156
+ codes[i] = -1;
157
+ continue;
158
+ }
159
+ c = dom.length;
160
+ index.set(k, c);
161
+ dom.push(values[i]);
162
+ }
163
+ codes[i] = c;
164
+ }
165
+ return { codes, domain: dom };
166
+ }
167
+ /** Ascending comparator for mixed values (numbers, dates, strings). */
168
+ export function ascending(a, b) {
169
+ if (isMissing(a))
170
+ return isMissing(b) ? 0 : 1;
171
+ if (isMissing(b))
172
+ return -1;
173
+ if (a instanceof Date || b instanceof Date)
174
+ return toNumber(a) - toNumber(b);
175
+ if (typeof a === "number" && typeof b === "number")
176
+ return a - b;
177
+ const sa = String(a);
178
+ const sb = String(b);
179
+ return sa < sb ? -1 : sa > sb ? 1 : 0;
180
+ }
181
+ export function descending(a, b) {
182
+ return ascending(b, a);
183
+ }
184
+ /** Format a value for labels/tooltips/summaries. */
185
+ export function formatValue(v, type) {
186
+ if (isMissing(v))
187
+ return "";
188
+ if (v instanceof Date || type === "temporal") {
189
+ const d = v instanceof Date ? v : new Date(toNumber(v));
190
+ const hasTime = d.getUTCHours() || d.getUTCMinutes() || d.getUTCSeconds();
191
+ return hasTime ? d.toISOString().replace("T", " ").replace(/:\d\d\.\d{3}Z$/, "") : d.toISOString().slice(0, 10);
192
+ }
193
+ if (typeof v === "number") {
194
+ if (Number.isInteger(v))
195
+ return String(v);
196
+ const a = Math.abs(v);
197
+ if (a >= 1000)
198
+ return v.toLocaleString(undefined, { maximumFractionDigits: 0 });
199
+ if (a >= 10)
200
+ return v.toLocaleString(undefined, { maximumFractionDigits: 1 });
201
+ return v.toLocaleString(undefined, { maximumSignificantDigits: 3 });
202
+ }
203
+ return String(v);
204
+ }
205
+ //# sourceMappingURL=channel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,70 @@
1
+ /** `plot()` and the `Chart` it returns. */
2
+ import type { EChartsOption } from "echarts";
3
+ import type { Insight, Mark, Markish, PlotOptions } from "./types.js";
4
+ import { type Compiled } from "./compile/index.js";
5
+ import type { Scales } from "./compile/scales.js";
6
+ import type { Theme } from "./theme.js";
7
+ export interface RenderOptions {
8
+ /** `"canvas"` (default) or `"svg"`. */
9
+ renderer?: "canvas" | "svg";
10
+ /** Override the theme passed to `echarts.init`. */
11
+ theme?: string | Record<string, unknown>;
12
+ width?: number;
13
+ height?: number;
14
+ /** Re-render on window resize (default true). */
15
+ autoResize?: boolean;
16
+ /** Pass `{ notMerge: true }` etc. to `setOption`. */
17
+ setOption?: Record<string, unknown>;
18
+ devicePixelRatio?: number;
19
+ }
20
+ /** Minimal shape of an ECharts instance we rely on (keeps `echarts` a peer dependency). */
21
+ export interface ChartInstance {
22
+ setOption(option: unknown, opts?: unknown): void;
23
+ resize(opts?: unknown): void;
24
+ dispose(): void;
25
+ on(event: string, handler: (...args: unknown[]) => void): void;
26
+ off(event: string, handler?: (...args: unknown[]) => void): void;
27
+ getDom(): HTMLElement;
28
+ getHeight(): number;
29
+ renderToSVGString?(opts?: unknown): string;
30
+ }
31
+ /** A compiled chart: an ECharts option plus the insights that were computed. */
32
+ export declare class Chart {
33
+ readonly option: EChartsOption;
34
+ readonly insights: Insight[];
35
+ readonly warnings: string[];
36
+ readonly marks: Mark[];
37
+ readonly scales: Scales;
38
+ readonly theme: Theme;
39
+ readonly options: PlotOptions;
40
+ private compiled;
41
+ constructor(options: PlotOptions, compiled: Compiled);
42
+ /** The ECharts option (for `chart.setOption(...)` with your own instance). */
43
+ toOption(): EChartsOption;
44
+ /** Human-readable insight summaries. */
45
+ describe(): string[];
46
+ /** Render into a DOM element with ECharts (loads `echarts/core` + components). */
47
+ render(element: HTMLElement, opts?: RenderOptions): Promise<ChartInstance>;
48
+ /** Render to an SVG string without a DOM (server-side / tests). */
49
+ toSVG(opts?: {
50
+ width?: number;
51
+ height?: number;
52
+ }): Promise<string>;
53
+ /** Re-compile with changed options (e.g. a new theme or more marks). */
54
+ with(patch: Partial<PlotOptions>): Chart;
55
+ /** Internal compile result (resolved marks, facet plan). */
56
+ get internals(): Compiled;
57
+ }
58
+ /**
59
+ * Compile marks into a chart.
60
+ *
61
+ * ```ts
62
+ * const chart = plot({
63
+ * marks: [lineY(data, { x: "date", y: "value", stroke: "series" }), ruleY([0])],
64
+ * insights: { anomalies: true, forecast: { horizon: 30 } },
65
+ * });
66
+ * await chart.render(document.querySelector("#chart"));
67
+ * ```
68
+ */
69
+ export declare function plot(options: PlotOptions | Markish): Chart;
70
+ //# sourceMappingURL=chart.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../src/chart.ts"],"names":[],"mappings":"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"}
package/dist/chart.js ADDED
@@ -0,0 +1,68 @@
1
+ /** `plot()` and the `Chart` it returns. */
2
+ import { compile } from "./compile/index.js";
3
+ /** A compiled chart: an ECharts option plus the insights that were computed. */
4
+ export class Chart {
5
+ option;
6
+ insights;
7
+ warnings;
8
+ marks;
9
+ scales;
10
+ theme;
11
+ options;
12
+ compiled;
13
+ constructor(options, compiled) {
14
+ this.options = options;
15
+ this.compiled = compiled;
16
+ this.option = compiled.option;
17
+ this.insights = compiled.insights;
18
+ this.warnings = compiled.warnings;
19
+ this.marks = compiled.marks;
20
+ this.scales = compiled.scales;
21
+ this.theme = compiled.theme;
22
+ }
23
+ /** The ECharts option (for `chart.setOption(...)` with your own instance). */
24
+ toOption() {
25
+ return this.option;
26
+ }
27
+ /** Human-readable insight summaries. */
28
+ describe() {
29
+ return this.insights.map((i) => i.summary);
30
+ }
31
+ /** Render into a DOM element with ECharts (loads `echarts/core` + components). */
32
+ async render(element, opts = {}) {
33
+ const { renderChart } = await import("./render.js");
34
+ return renderChart(this, element, opts);
35
+ }
36
+ /** Render to an SVG string without a DOM (server-side / tests). */
37
+ async toSVG(opts = {}) {
38
+ const { renderSVG } = await import("./render.js");
39
+ return renderSVG(this, opts);
40
+ }
41
+ /** Re-compile with changed options (e.g. a new theme or more marks). */
42
+ with(patch) {
43
+ return plot({ ...this.options, ...patch });
44
+ }
45
+ /** Internal compile result (resolved marks, facet plan). */
46
+ get internals() {
47
+ return this.compiled;
48
+ }
49
+ }
50
+ /**
51
+ * Compile marks into a chart.
52
+ *
53
+ * ```ts
54
+ * const chart = plot({
55
+ * marks: [lineY(data, { x: "date", y: "value", stroke: "series" }), ruleY([0])],
56
+ * insights: { anomalies: true, forecast: { horizon: 30 } },
57
+ * });
58
+ * await chart.render(document.querySelector("#chart"));
59
+ * ```
60
+ */
61
+ export function plot(options) {
62
+ const o = isPlotOptions(options) ? options : { marks: options };
63
+ return new Chart(o, compile(o));
64
+ }
65
+ function isPlotOptions(v) {
66
+ return typeof v === "object" && v !== null && !Array.isArray(v) && !("type" in v && "data" in v);
67
+ }
68
+ //# sourceMappingURL=chart.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chart.js","sourceRoot":"","sources":["../src/chart.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAI3C,OAAO,EAAE,OAAO,EAAiB,MAAM,oBAAoB,CAAC;AA8B5D,gFAAgF;AAChF,MAAM,OAAO,KAAK;IACP,MAAM,CAAgB;IACtB,QAAQ,CAAY;IACpB,QAAQ,CAAW;IACnB,KAAK,CAAS;IACd,MAAM,CAAS;IACf,KAAK,CAAQ;IACb,OAAO,CAAc;IACtB,QAAQ,CAAW;IAE3B,YAAY,OAAoB,EAAE,QAAkB;QAClD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,8EAA8E;IAC9E,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,wCAAwC;IACxC,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,MAAM,CAAC,OAAoB,EAAE,OAAsB,EAAE;QACzD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACpD,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,KAAK,CAAC,OAA4C,EAAE;QACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,wEAAwE;IACxE,IAAI,CAAC,KAA2B;QAC9B,OAAO,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,4DAA4D;IAC5D,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,IAAI,CAAC,OAA8B;IACjD,MAAM,CAAC,GAAgB,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAoB,EAAE,CAAC;IAC1F,OAAO,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC;AACnG,CAAC"}
@@ -0,0 +1,28 @@
1
+ /** `plot()`: marks → resolved marks → insights → scales → ECharts option. */
2
+ import type { EChartsOption } from "echarts";
3
+ import type { Insight, Mark, PlotOptions } from "../types.js";
4
+ import { getBackend } from "../backend/index.js";
5
+ import { type FacetPlan, type ResolvedMark } from "./resolve.js";
6
+ import { type Scales } from "./scales.js";
7
+ import { type Theme } from "../theme.js";
8
+ export interface Compiled {
9
+ option: EChartsOption;
10
+ insights: Insight[];
11
+ warnings: string[];
12
+ scales: Scales;
13
+ marks: Mark[];
14
+ resolved: ResolvedMark[];
15
+ plan: FacetPlan;
16
+ theme: Theme;
17
+ /** Grid option for a given chart height (default margins shrink on short charts); used to refit at render time. */
18
+ gridFor: (height: number | undefined) => Record<string, unknown>[];
19
+ }
20
+ export declare function compile(options: PlotOptions): Compiled;
21
+ /**
22
+ * Merge the `echarts` escape hatch into the compiled option. Series are appended. Where isopleth emits an
23
+ * array (axes, grids, titles, visualMaps, dataZooms), an array patches entry by entry and an object patches
24
+ * every entry for axes and grids, the first entry otherwise.
25
+ */
26
+ export declare function mergeOption(a: Record<string, unknown>, b: Record<string, unknown>): Record<string, unknown>;
27
+ export { getBackend };
28
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compile/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKjD,OAAO,EAA2B,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAmC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAKvD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,mHAAmH;IACnH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACpE;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAwItD;AAmND;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU3G;AAgBD,OAAO,EAAE,UAAU,EAAE,CAAC"}