@jarenjs/charts 0.67.0 → 0.72.2

package/README.md

@@ -302,14 +302,14 @@ Measured (`npm run benchmark:charts`, one appended point):
 <!--fact:charts.sessionTable-->
 | points × series | session tick | wholesale tick | frames incremental |
 |---|---:|---:|---:|
-| 100 × 5 | 6.26 µs | 301 µs | 1100 of 1100 |
-| 1,000 × 5 | 4.84 µs | 1.1 ms | 1100 of 1100 |
-| 10,000 × 5 | 4.44 µs | 8.61 ms | 1100 of 1100 |
-| 10,000 × 5 *(sampled)* | 3.25 ms | 2.53 ms | 0 of 1100 |
+| 100 × 5 | 5.82 µs | 306 µs | 1100 of 1100 |
+| 1,000 × 5 | 5.5 µs | 1 ms | 1100 of 1100 |
+| 10,000 × 5 | 7.9 µs | 8.41 ms | 1100 of 1100 |
+| 10,000 × 5 *(sampled)* | 2.5 ms | 2.52 ms | 0 of 1100 |
 <!--/fact-->
 
 The session tick is *flat* in n — it
-moves <!--fact:charts.sessionFlatness-->0.7× while the wholesale tick grows 28.6×<!--/fact-->. Supported types: `line` (appends
+moves <!--fact:charts.sessionFlatness-->1.4× while the wholesale tick grows 27.4×<!--/fact-->. Supported types: `line` (appends
 and ring-buffer evictions), `bar` (live counts and sums) and
 `candlestick` (keyed kline upserts — one candle group re-renders). The
 website's Binance demo runs on it.
@@ -382,14 +382,14 @@ Measured (`npm run benchmark:charts`, one series):
 <!--fact:charts.samplingTable-->
 | source points | drawn | method | source → AST | source → svg |
 |---:|---:|---|---:|---:|
-| 2,000 | 2,000 | none | 73.4 µs → 72.3 µs | 587 µs → 515 µs |
-| 20,000 | 560 | lttb | 838 µs → 1.28 ms | 5.84 ms → 1.05 ms |
-| 100,000 | 560 | lttb | 4.35 ms → 5.36 ms | 27.8 ms → 5.42 ms |
+| 2,000 | 2,000 | none | 77.1 µs → 71.5 µs | 512 µs → 518 µs |
+| 20,000 | 560 | lttb | 672 µs → 911 µs | 5.94 ms → 1.06 ms |
+| 100,000 | 560 | lttb | 4.08 ms → 5.33 ms | 28.3 ms → 6.61 ms |
 <!--/fact-->
 
 Choosing the points costs about what mapping them costs — the sampler
 reads every reading either way — so the AST column is a small **loss**.
-What it buys is the render — <!--fact:charts.samplingWin-->100,000 points draw as 560 and render 5.1× faster<!--/fact-->. The invariants above are asserted in the benchmark
+What it buys is the render — <!--fact:charts.samplingWin-->100,000 points draw as 560 and render 4.3× faster<!--/fact-->. The invariants above are asserted in the benchmark
 before a single timing is printed.
 
 **Sampling is not retention.** `createStreamAdapter`'s `maxPoints`
@@ -427,3 +427,6 @@ Every subpath a consumer can import, derived from the manifest by
 | `@jarenjs/charts/schemas/chart-definition.schema.json` | schema | — |
 | `@jarenjs/charts/package.json` | metadata | — |
 <!--/fact-->
+
+Author definitions in code with the typed [chart pen](../../packages/linq/docs/CHARTS-PEN.md),
+then pass its `.schema` directly to `compileChart`.

package/dist/types/types/line.d.ts

@@ -177,6 +177,14 @@ export declare function lineVertex(p: any, xDrop: number | null, xScale: (v: num
  * @returns {LineAST}
  */
 export declare function buildLineAST(data: any, config?: any): LineAST;
+/** Build from the same resolved domains a session already used for its frame decision.
+ * Internal to the chart engine; public builds always scan their own input.
+ * @param {{name?: string, points: any[]}[]} input @param {any} config
+ * @param {ReturnType<typeof resolveLineDomains>} domains @returns {LineAST} */
+export declare function buildLineASTResolved(input: {
+    name?: string;
+    points: any[];
+}[], config: any, domains: ReturnType<typeof resolveLineDomains>): LineAST;
 export type LineSeriesRender = {
     /**
      * the series' `<g>` vnode

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jarenjs/charts",
   "private": false,
-  "version": "0.67.0",
+  "version": "0.72.2",
   "type": "module",
   "main": "./src/index.js",
   "types": "./dist/types/index.d.ts",
@@ -70,7 +70,7 @@
     "prepack": "npm run build:types"
   },
   "dependencies": {
-    "@jarenjs/core": "^0.67.0",
-    "@jarenjs/view": "^0.67.0"
+    "@jarenjs/core": "^0.72.2",
+    "@jarenjs/view": "^0.72.2"
   }
 }

package/src/core/session.js

@@ -38,7 +38,7 @@ import {
   scanBarExtremes, resolveBarDomains, barScale,
 } from '../types/bar.js';
 import {
-  buildLineAST, buildLineRender, scanLineExtremes, resolveLineDomains,
+  buildLineASTResolved, buildLineRender, scanLineExtremes, resolveLineDomains,
   lineScales, lineVertex, lineSeriesRender, lineSeriesChildren,
 } from '../types/line.js';
 import {
@@ -206,9 +206,10 @@ function createLineSession(config, source, options) {
     const input = (data?.series ?? []).filter((s) => Array.isArray(s.points));
     filteredSeries = input.length !== (data?.series ?? []).length;
     ext = scanLineExtremes(input, policy, log);
-    ast = buildLineAST(data, config);
+    const domains = resolveLineDomains(ext, policy, time, log);
+    ast = buildLineASTResolved(input, config, domains);
     render = buildLineRender(ast, theme, hash, options);
-    xDrop = resolveLineDomains(ext, policy, time, log).xDrop;
+    xDrop = domains.xDrop;
     vnode = render.svg;
     return { vnode, mode: /** @type {const} */ ('rebuilt') };
   }

package/src/types/line.js

@@ -219,6 +219,16 @@ export function buildLineAST(data, config = {}) {
   const log = config.log === true;
   const policy = normalizeDomainPolicy(config.domain);
   const domains = resolveLineDomains(scanLineExtremes(input, policy, log), policy, time, log);
+  return buildLineASTResolved(input, config, domains);
+}
+
+/** Build from the same resolved domains a session already used for its frame decision.
+ * Internal to the chart engine; public builds always scan their own input.
+ * @param {{name?: string, points: any[]}[]} input @param {any} config
+ * @param {ReturnType<typeof resolveLineDomains>} domains @returns {LineAST} */
+export function buildLineASTResolved(input, config, domains) {
+  const time = config.x === 'time';
+  const log = config.log === true;
   const { xScale, yScale } = lineScales(domains, time, log);
   const timeLabel = time
     ? compileTimeTickFormat({ dateNames: config.dateNames, timeFormats: config.timeFormats })