@react-x11/components 0.1.0 → 0.2.1

package/dist/charts/hx.js

@@ -0,0 +1,15 @@
+// `React.createElement`, typed against react-x11's host elements — a copy
+// of `src/calendar/hx.ts`, and deliberately a copy: a component importing
+// another component's private module makes the two one unit for a bundler
+// (AGENTS.md, "No component imports another component").
+//
+// `React.createElement`'s own overloads are `@types/react`'s and describe
+// the DOM, so a `<box onMouseMove>` handler would be checked against
+// React's MouseEvent rather than react-x11's. `hx('box', …)` looks the
+// name up in react-x11's element table instead, and `hx('div', …)` is an
+// error.
+import React from 'react';
+export function hx(type, props, ...children) {
+    return React.createElement(type, props, ...children);
+}
+//# sourceMappingURL=hx.js.map

package/dist/charts/hx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx.js","sourceRoot":"","sources":["../../src/charts/hx.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,yDAAyD;AACzD,EAAE;AACF,0EAA0E;AAC1E,qEAAqE;AACrE,uEAAuE;AACvE,yEAAyE;AACzE,SAAS;AACT,OAAO,KAAK,MAAM,OAAO,CAAC;AAsB1B,MAAM,UAAU,EAAE,CAChB,IAAO,EACP,KAAqD,EACrD,GAAG,QAAqB;IAExB,OAAO,KAAK,CAAC,aAAa,CAAC,IAAc,EAAE,KAAc,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/charts/index.d.ts

@@ -0,0 +1,27 @@
+import { ELEMENT } from './node.js';
+import type { ChartPlotProps } from './node.js';
+export { ChartContainer, LineChart, AreaChart, BarChart, ScatterChart, LineSeries, AreaSeries, BarSeries, ScatterSeries, XAxis, YAxis, CartesianGrid, ChartTooltip, ChartLegend, } from './components.js';
+export type { ChartContainerProps, CartesianChartProps, ChartPlotHandle, SeriesProps, XAxisProps, YAxisProps, CartesianGridProps, ChartTooltipProps, ChartLegendProps, TooltipData, } from './components.js';
+export { ChartData, isChartDataLike } from './data.js';
+export type { ChartDataOptions, ChartDataChange, ChartDataLike, ChartRow, ColumnarData, ChartSourceData, } from './data.js';
+export type { ChartConfig, ChartFrameStats } from './spec.js';
+export type { ChartPlotProps, ChartHit, ChartFormatters } from './node.js';
+/** The host element name, for apps that would rather write `<chartplot>`. */
+export { ELEMENT as CHARTPLOT_ELEMENT };
+declare module 'react-x11/jsx-runtime' {
+    namespace JSX {
+        interface IntrinsicElements {
+            chartplot: ChartPlotProps & {
+                onMouseMove?: (ev: {
+                    x: number;
+                    y: number;
+                }) => void;
+                onMouseLeave?: (ev: {
+                    x: number;
+                    y: number;
+                }) => void;
+            };
+        }
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/charts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/charts/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAiB,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAkBhD,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,KAAK,EACL,KAAK,EACL,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACvD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE3E,6EAA6E;AAC7E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,CAAC;AAIxC,OAAO,QAAQ,uBAAuB,CAAC;IACrC,UAAU,GAAG,CAAC;QACZ,UAAU,iBAAiB;YACzB,SAAS,EAAE,cAAc,GAAG;gBAC1B,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE;oBAAE,CAAC,EAAE,MAAM,CAAC;oBAAC,CAAC,EAAE,MAAM,CAAA;iBAAE,KAAK,IAAI,CAAC;gBACrD,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE;oBAAE,CAAC,EAAE,MAAM,CAAC;oBAAC,CAAC,EAAE,MAAM,CAAA;iBAAE,KAAK,IAAI,CAAC;aACvD,CAAC;SACH;KACF;CACF"}

package/dist/charts/index.js

@@ -0,0 +1,38 @@
+// Charts — shadcn-shaped composition over one registered element that
+// paints with cost bounded by pixels, not points. `docs/prd-charts.md` is
+// the design record; the pieces:
+//
+//  - `data.ts` — column resolution, the streaming `ChartData` store, the
+//    min/max pyramid and x-index (pure, display-free);
+//  - `scale.ts` — linear/band scales, nice/time ticks (pure);
+//  - `render.ts` — the series renderers and the command-vs-pixels policy;
+//  - `node.ts` — the `<chartplot>` retained node: one paint pass for grid,
+//    axes and series, plus the tooltip's hit answers;
+//  - `components.ts` — `ChartContainer`, the chart wrappers and the
+//    config-carrier children.
+//
+// **Registration happens when this module is evaluated** — the one side
+// effect tree-shaking relies on being here and nowhere shallower (AGENTS.md,
+// "Tree-shaking is a constraint, not a nice-to-have").
+import { registerElement, registeredElements } from 'react-x11/host';
+import { ChartPlotNode, ELEMENT } from './node.js';
+// Idempotent on purpose: `registerElement` throws on a second registration
+// without `override`, which is right for two packages fighting over a name —
+// but two copies of this one (a lockfile skew) should not fail to boot over
+// a name both of them mean the same thing by.
+if (!registeredElements().includes(ELEMENT)) {
+    registerElement(ELEMENT, {
+        create: (props, app) => new ChartPlotNode(props, app),
+        // `data` and `spec` are not style names today, but `color`-adjacent
+        // vocabulary has drifted into styles before; declaring everything the
+        // element reads keeps a future style name from turning these props
+        // into DEV throws (AGENTS.md, "Gotchas").
+        semanticNames: ['spec', 'data', 'formatters'],
+        childrenAllowed: false,
+    });
+}
+export { ChartContainer, LineChart, AreaChart, BarChart, ScatterChart, LineSeries, AreaSeries, BarSeries, ScatterSeries, XAxis, YAxis, CartesianGrid, ChartTooltip, ChartLegend, } from './components.js';
+export { ChartData, isChartDataLike } from './data.js';
+/** The host element name, for apps that would rather write `<chartplot>`. */
+export { ELEMENT as CHARTPLOT_ELEMENT };
+//# sourceMappingURL=index.js.map

package/dist/charts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/charts/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,0EAA0E;AAC1E,iCAAiC;AACjC,EAAE;AACF,yEAAyE;AACzE,uDAAuD;AACvD,8DAA8D;AAC9D,0EAA0E;AAC1E,2EAA2E;AAC3E,sDAAsD;AACtD,oEAAoE;AACpE,8BAA8B;AAC9B,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,uDAAuD;AACvD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAOrE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,8CAA8C;AAC9C,IAAI,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,eAAe,CAAC,OAAO,EAAE;QACvB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC;QACrD,oEAAoE;QACpE,sEAAsE;QACtE,mEAAmE;QACnE,0CAA0C;QAC1C,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC;QAC7C,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,KAAK,EACL,KAAK,EACL,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAczB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAavD,6EAA6E;AAC7E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/charts/node.d.ts

@@ -0,0 +1,96 @@
+import { Node } from 'react-x11/node';
+import type { Context2D, MeasureConstraints, MeasuredSize } from 'react-x11/node';
+import type { Style } from 'react-x11/style';
+import type { ChartSourceData } from './data.js';
+import type { ChartFrameStats, PlotSpec } from './spec.js';
+import type { PlotRect } from './render.js';
+/** The element name — registration key, node kind and JSX tag alike. */
+export declare const ELEMENT = "chartplot";
+/** Formatter channel. The component layer keeps ONE mutable object per
+ * chart and updates its fields, so the prop's identity never changes and a
+ * formatter defined inline never damages the plot. */
+export interface ChartFormatters {
+    x?: (value: number | string) => string;
+    y?: (value: number) => string;
+}
+export interface ChartPlotProps {
+    spec: PlotSpec;
+    data: ChartSourceData;
+    formatters?: ChartFormatters;
+    /** Reported once per painted frame, off the paint stack. */
+    onFrameStats?: (stats: ChartFrameStats) => void;
+    style?: Style | Style[];
+}
+/** What the tooltip layer gets for a pointer position. */
+export interface ChartHit {
+    index: number;
+    /** The x value at that index — a label for band axes. */
+    xValue: number | string;
+    /** Snap position for the crosshair, window coordinates. */
+    px: number;
+    /** The x domain's width (0 for band axes) — what a time-axis tooltip
+     * sizes its default header format to, exactly as the ticks do. */
+    xSpan: number;
+    plot: PlotRect;
+    points: {
+        id: string;
+        label: string;
+        color: string;
+        value: number;
+        py: number;
+    }[];
+}
+export type NtkApp = ConstructorParameters<typeof Node>[2];
+export declare class ChartPlotNode extends Node {
+    private _layoutCache;
+    private _labelLayouts;
+    private _scatterGrids;
+    private _stacks;
+    private _unsubscribe;
+    private _image;
+    constructor(props: Record<string, unknown>, app: NtkApp);
+    private _props;
+    applyProps(nextProps: Record<string, unknown>, prevProps: Record<string, unknown>): void;
+    private _subscribeData;
+    /**
+     * Entirely outside the owning window, by public geometry alone. Core
+     * culls the *paint* of offscreen nodes on its own; this is only about
+     * skipping the invalidation a streaming append would otherwise schedule.
+     * Conservative: any doubt answers "maybe visible".
+     */
+    private _fullyOffscreen;
+    destroySubtree(): void;
+    /** A chart with no styled size still shows up usefully — the HTML canvas
+     * default, scaled a little. Flex sizing overrides it as usual. */
+    measureContent(constraints: MeasureConstraints): MeasuredSize;
+    private _dataVersion;
+    /** Wrap a stack layer as a column with a stable cache host, so its
+     * pyramid survives the layer array being reallocated by growth. */
+    private _stackColumn;
+    /**
+     * Cumulative tops for a stack group, extended incrementally on append
+     * and rebuilt when membership or history changes.
+     */
+    private _stackTops;
+    private _themeRecord;
+    private _color;
+    /** Measure one label through the font service, cached. Null without a
+     * font service (the mock backend) — callers fall back to fixed gutters. */
+    private _label;
+    private _layout;
+    private _cachedSpec;
+    private _cachedTheme;
+    private _host;
+    private _paintCtx;
+    paint(ctx: Context2D): void;
+    private _paintGridAndAxes;
+    /** The plot rectangle in window coordinates, for overlay positioning. */
+    plotRect(): PlotRect | null;
+    /**
+     * What is under a window-coordinate pointer x: the snapped index, its x
+     * value, and every series' value and pixel position there. Null outside
+     * the data or before layout. O(log n) against sorted data.
+     */
+    hitAt(winX: number): ChartHit | null;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/charts/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/charts/node.ts"],"names":[],"mappings":"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"}