@primeui/chart-core 0.0.1-alpha.1

package/dist/utils/specialized/index.mjs

@@ -0,0 +1,66 @@
+export { detectStreamingUpdateKind, streamingPointsInterpolator } from '../../chunk-XQQCGFYB.mjs';
+import '../../chunk-WH3C3Y7P.mjs';
+export { DEFAULT_EXPORT_MENU_ITEMS, DEFAULT_EXPORT_MENU_PROPS, EXPORT_MENU_CONSTANTS, EXPORT_MENU_LABELS, HAMBURGER_ICON_PATH, ScatterDecimator, decimate, decimateKMeans, decimateLTTB, decimateMinMax, estimateExportMenuHeight, filterExportMenuItems, getExportAction, isExportMenuSeparator, resolveExportMenuPlacement, resolveExportMenuProps } from '../../chunk-OWW3K55O.mjs';
+export { buildAncestorChain, buildDrilldownTree, createDrilldownState, drillInto, drillToLevel, drillToRoot, drillUp, getAncestorPath, getChildren, getDrilldownRootLabel, getLeaves, isDrilldownEnabled, isParentNode } from '../../chunk-WA3OVISZ.mjs';
+export { buildQuadtree } from '../../chunk-C36VWQ7A.mjs';
+export { diceLayout, resquarify, sliceDiceLayout, sliceLayout, squarify } from '../../chunk-BETFQBM2.mjs';
+export { ZoomPanController } from '../../chunk-WRULPWHD.mjs';
+import '../../chunk-QS76E3TD.mjs';
+import '../../chunk-O2X6FF45.mjs';
+import '../../chunk-SSLTFJ3U.mjs';
+import { createLinearScale } from '../../chunk-RQ3CKQOX.mjs';
+
+// src/utils/specialized/zoom.utils.ts
+function isZoomed(state) {
+  return state.x !== null || state.y !== null;
+}
+function normalizeZoomState(state, originals) {
+  const atFullExtent = (w, domain) => {
+    if (!w || !domain) return false;
+    const range = domain[1] - domain[0];
+    const eps = Math.max(Math.abs(range), 1) * 1e-9;
+    return Math.abs(w.min - domain[0]) <= eps && Math.abs(w.max - domain[1]) <= eps;
+  };
+  const nextX = atFullExtent(state.x, originals.x) ? null : state.x;
+  const nextY = atFullExtent(state.y, originals.y) ? null : state.y;
+  if (nextX === state.x && nextY === state.y) return state;
+  return { x: nextX, y: nextY };
+}
+function createInitialZoomState() {
+  return { x: null, y: null };
+}
+function normalizeSubConfig(value, defaults) {
+  if (value === false) return null;
+  if (value === true || value === void 0) return defaults;
+  return { ...defaults, ...value };
+}
+function buildZoomScales(layoutData, zoomState) {
+  const isVertical = layoutData.orientation === "vertical";
+  const timeScale = layoutData.sharedTimeScale;
+  const firstValueScale = layoutData.valueScales.values().next().value;
+  const scatterXScale = layoutData.scatterXScales?.values().next().value;
+  let categoryIndexScale;
+  if (!timeScale && !scatterXScale) {
+    const origDomain = isVertical ? layoutData.originalDomains?.x : layoutData.originalDomains?.y;
+    const catRange = isVertical ? [layoutData.cartesianArea.x, layoutData.cartesianArea.x + layoutData.cartesianArea.width] : [layoutData.cartesianArea.y, layoutData.cartesianArea.y + layoutData.cartesianArea.height];
+    if (origDomain) {
+      const zoomAxis = isVertical ? zoomState?.x : zoomState?.y;
+      const activeDomain = zoomAxis ? [zoomAxis.min, zoomAxis.max] : origDomain;
+      const bandScale = layoutData.sharedCategoryScale;
+      const bandDomain = bandScale?.domain();
+      if (bandScale && bandDomain && bandDomain.length > 0) {
+        const bw = bandScale.bandwidth();
+        const firstPos = (bandScale(bandDomain[0]) ?? catRange[0]) + bw / 2;
+        const lastPos = (bandScale(bandDomain[bandDomain.length - 1]) ?? catRange[1]) + bw / 2;
+        categoryIndexScale = createLinearScale(activeDomain, [firstPos, lastPos]);
+      } else {
+        categoryIndexScale = createLinearScale(activeDomain, catRange);
+      }
+    }
+  }
+  const xScale = isVertical ? timeScale ?? scatterXScale ?? categoryIndexScale ?? void 0 : firstValueScale;
+  const yScale = isVertical ? firstValueScale : timeScale ?? scatterXScale ?? categoryIndexScale ?? void 0;
+  return { x: xScale, y: yScale };
+}
+
+export { buildZoomScales, createInitialZoomState, isZoomed, normalizeSubConfig, normalizeZoomState };

package/dist/utils/text/index.d.mts

@@ -0,0 +1,39 @@
+export { C as CHAR_WIDTH_RATIO, c as calculateWrappedTextHeight, b as calculateWrappedTextWidth, d as cleanupMeasureContext, e as clearTextWidthCache, g as createSvgTitle, f as formatCompactValue, a as formatDataLabelText, h as getTitleAnchor, i as getTitleX, j as getTitleY, o as measureFontMetrics, m as measureText, k as measureTextWidth, n as normalizeDataLabelConfig, r as renderCanvasTitle, s as setTextMeasurer, l as svgAnchorToCanvasAlign, w as wrapText } from '../../datalabel.utils-CkjGeB8S.mjs';
+import { CollisionAvoidanceOptions, CollisionResult } from '@primeui/chart-types';
+
+/**
+ * Resolve label collisions via sequential pipeline: auto-rotate → auto-skip.
+ *
+ * 1. If labels collide at 0° and autoRotate is enabled (horizontal axes only),
+ *    switch to autoRotateAngle.
+ * 2. Find the minimum skip step so that visible labels don't overlap at the
+ *    effective rotation.
+ *
+ * When manualRotation is set (tickRotation prop), it takes priority over
+ * auto-rotation — only the skip stage runs.
+ */
+declare function resolveCollisionAvoidance(options: CollisionAvoidanceOptions): CollisionResult;
+/**
+ * Check whether adjacent labels collide at the given rotation.
+ */
+declare function hasCollisions(labels: string[], positions: number[], fontSize: number, fontWeight: string, fontFamily: string, rotation: number, minSpacing: number, isHorizontal?: boolean): boolean;
+/**
+ * Calculate the axis-parallel footprint of a label at a given rotation.
+ *
+ * At rotation=0 the footprint equals the label width.
+ * At rotation≠0 the footprint is the projection of the rotated bounding box
+ * onto the axis direction: width·|cos(θ)| + height·|sin(θ)|.
+ */
+declare function calculateLabelFootprint(labelWidth: number, fontSize: number, rotation: number): number;
+/**
+ * Adjust text anchor and baseline for rotated data labels.
+ * When labels above bars are rotated, the default 'middle'/'auto' alignment
+ * no longer visually centers them — we need to adjust based on the rotation angle
+ * so labels stay aligned to bar centers and extend away from the bar.
+ */
+declare function adjustLabelForRotation(rotation: number, textAnchor: string, baseline: string): {
+    textAnchor: string;
+    baseline: string;
+};
+
+export { adjustLabelForRotation, calculateLabelFootprint, hasCollisions, resolveCollisionAvoidance };

package/dist/utils/text/index.mjs

@@ -0,0 +1,8 @@
+export { formatDataLabelText, normalizeDataLabelConfig } from '../../chunk-OXTFAWSK.mjs';
+export { adjustLabelForRotation, calculateLabelFootprint, hasCollisions, resolveCollisionAvoidance } from '../../chunk-R6Y3R7EW.mjs';
+export { CHAR_WIDTH_RATIO, calculateWrappedTextHeight, calculateWrappedTextWidth, cleanupMeasureContext, clearTextWidthCache, createSvgTitle, formatCompactValue, getTitleAnchor, getTitleX, getTitleY, measureFontMetrics, measureText, measureTextWidth, renderCanvasTitle, setTextMeasurer, svgAnchorToCanvasAlign, wrapText } from '../../chunk-XTVE4P3L.mjs';
+import '../../chunk-NKUYIWAP.mjs';
+import '../../chunk-QS76E3TD.mjs';
+import '../../chunk-O2X6FF45.mjs';
+import '../../chunk-SSLTFJ3U.mjs';
+import '../../chunk-RQ3CKQOX.mjs';

package/dist/utils/theme/index.d.mts

@@ -0,0 +1,295 @@
+import { GlobalFont } from '@primeui/chart-types';
+import { ChartTheme } from '@primeui/chart-types/theme';
+
+/** Default colors for light mode */
+declare const LIGHT_MODE_COLORS: {
+    readonly text: "#000000";
+    readonly background: "#ffffff";
+    readonly surfaceBackground: "#f5f5f5";
+};
+/** Default colors for dark mode */
+declare const DARK_MODE_COLORS: {
+    readonly text: "#ffffff";
+    readonly background: "#3f3f46";
+    readonly surfaceBackground: "#27272a";
+};
+/** Axis line and tick mark color (light mode) — mirrors `--p-chart-axis` / `--p-chart-neutral-60`. */
+declare const DEFAULT_AXIS_COLOR = "#666666";
+/** Grid line color (light mode) — mirrors `--p-chart-grid` / `--p-chart-neutral-10`. */
+declare const DEFAULT_GRID_COLOR = "#e2e8f0";
+/** Tick label text color (light mode) — mirrors `--p-chart-tick-label-color` / `--p-chart-neutral-60`. */
+declare const DEFAULT_TICK_LABEL_COLOR = "#666666";
+/** Axis line and tick mark color (dark mode) */
+declare const DEFAULT_AXIS_COLOR_DARK = "#a1a1aa";
+/** Grid line color (dark mode) */
+declare const DEFAULT_GRID_COLOR_DARK = "#3f3f46";
+/** Tick label text color (dark mode) */
+declare const DEFAULT_TICK_LABEL_COLOR_DARK = "#a1a1aa";
+/** Default font family used across all chart text */
+declare const DEFAULT_FONT_FAMILY = "system-ui, sans-serif";
+/** Default tick label font size (px) */
+declare const DEFAULT_TICK_FONT_SIZE = 12;
+/** Default axis title font size (px) */
+declare const DEFAULT_TITLE_FONT_SIZE = 14;
+/** Length of tick mark in pixels */
+declare const DEFAULT_TICK_LENGTH = 6;
+/** Padding between tick mark and label in pixels */
+declare const DEFAULT_LABEL_PADDING = 8;
+/** Distance from axis to title text */
+declare const DEFAULT_TITLE_OFFSET = 45;
+/** Chart title font size (px) — larger than axis title */
+declare const DEFAULT_CHART_TITLE_FONT_SIZE = 16;
+/** Padding around chart title (px) */
+declare const DEFAULT_CHART_TITLE_PADDING = 10;
+/** Chart caption font size (px) */
+declare const DEFAULT_CHART_CAPTION_FONT_SIZE = 13;
+/** Padding around chart caption (px) — asymmetric: less above, more below to separate from chart */
+declare const DEFAULT_CHART_CAPTION_PADDING: {
+    readonly top: 8;
+    readonly bottom: 20;
+};
+/** Default chart padding on each side (px) */
+declare const DEFAULT_CHART_PADDING = 10;
+/** Default legend height for top/bottom position (px) */
+declare const DEFAULT_LEGEND_HEIGHT = 30;
+/** Default legend width for left/right position (px) */
+declare const DEFAULT_LEGEND_WIDTH = 100;
+/** Padding around legend (px) */
+declare const DEFAULT_LEGEND_PADDING = 10;
+/** Chart title text color (light mode) — mirrors `--p-chart-neutral-100`. */
+declare const DEFAULT_CHART_TITLE_COLOR = "#0f172a";
+/** Chart title text color (dark mode) — mirrors `--p-chart-neutral-100` dark. */
+declare const DEFAULT_CHART_TITLE_COLOR_DARK = "#fafafa";
+/** Chart caption text color (light mode) — mirrors `--p-chart-neutral-40`. */
+declare const DEFAULT_CHART_CAPTION_COLOR = "#94a3b8";
+/** Chart caption text color (dark mode) — mirrors `--p-chart-neutral-40` dark. */
+declare const DEFAULT_CHART_CAPTION_COLOR_DARK = "#71717a";
+/** Data label text color (light mode) — mirrors `--p-chart-neutral-80`. */
+declare const DEFAULT_DATA_LABEL_COLOR = "#334155";
+/** Data label text color (dark mode) — mirrors `--p-chart-neutral-80` dark. */
+declare const DEFAULT_DATA_LABEL_COLOR_DARK = "#e4e4e7";
+/** Annotation text color (light mode) — mirrors `--p-chart-neutral-80`. */
+declare const DEFAULT_ANNOTATION_COLOR = "#334155";
+/** Annotation text color (dark mode) — mirrors `--p-chart-neutral-80` dark. */
+declare const DEFAULT_ANNOTATION_COLOR_DARK = "#e4e4e7";
+/** Data label font size (px) */
+declare const DEFAULT_DATA_LABEL_FONT_SIZE = 12;
+/** Data label font family */
+declare const DEFAULT_DATA_LABEL_FONT_FAMILY = "system-ui, sans-serif";
+/** Bracket line color (light mode) */
+declare const DEFAULT_BRACKET_COLOR = "#999";
+/** Bracket line color (dark mode) */
+declare const DEFAULT_BRACKET_COLOR_DARK = "#71717a";
+/** Group label color (light mode) */
+declare const DEFAULT_GROUP_LABEL_COLOR = "#444";
+/** Group label color (dark mode) */
+declare const DEFAULT_GROUP_LABEL_COLOR_DARK = "#a1a1aa";
+/** Group label font size (px) */
+declare const DEFAULT_GROUP_LABEL_FONT_SIZE = 11;
+/** Group label font weight */
+declare const DEFAULT_GROUP_LABEL_FONT_WEIGHT = 600;
+/** Crosshair line color (light mode) */
+declare const DEFAULT_CROSSHAIR_COLOR = "rgba(0, 0, 0, 0.5)";
+/** Crosshair line color (dark mode) */
+declare const DEFAULT_CROSSHAIR_COLOR_DARK = "rgba(255, 255, 255, 0.3)";
+/** Reference line stroke color — mirrors `defaultLightTheme.referenceLineColor` / `--p-chart-reference-line`. */
+declare const DEFAULT_REFERENCE_LINE_STROKE = "#94a3b8";
+/** Reference line stroke width (px) */
+declare const DEFAULT_REFERENCE_LINE_WIDTH = 1;
+/** Reference band fill color — mirrors `defaultLightTheme.referenceBandFill` / `--p-chart-reference-band`.
+ *  Alpha is baked in (`#0000001a` ≈ rgba(0,0,0,0.10)); no separate opacity multiplier needed. */
+declare const DEFAULT_REFERENCE_BAND_FILL = "#0000001a";
+/** Reference band fill opacity — kept for backwards compat with callers that apply it separately.
+ *  When using theme.referenceBandFill the alpha should be baked into the hex. */
+declare const DEFAULT_REFERENCE_BAND_OPACITY = 1;
+/** Reference line/band label font size (px) */
+declare const DEFAULT_REFERENCE_LABEL_FONT_SIZE = 11;
+/** Reference line/band label font weight */
+declare const DEFAULT_REFERENCE_LABEL_FONT_WEIGHT = 500;
+/** Reference line/band label offset from line (px) */
+declare const DEFAULT_REFERENCE_LABEL_OFFSET = 4;
+/** Brightness multiplier for the hovered item */
+declare const DEFAULT_HOVER_BRIGHTNESS = 1.1;
+/** Opacity applied to non-hovered items when something is hovered */
+declare const DEFAULT_HOVER_DIM_OPACITY = 0.6;
+/** Hover point radius multiplier — hovered marker = markerSize × this value */
+declare const DEFAULT_HOVER_POINT_RADIUS_MULTIPLIER = 1.3;
+/** Default hover offset for bars / pie slices (px) */
+declare const DEFAULT_HOVER_OFFSET = 0;
+/** Line series stroke width (px) */
+declare const DEFAULT_LINE_WIDTH = 2;
+/** Area fill opacity (0-1) */
+declare const DEFAULT_AREA_FILL_OPACITY = 0.3;
+/** Default marker size for line/radar series (px) */
+declare const DEFAULT_LINE_MARKER_SIZE = 4;
+/** Scatter point marker size (px) */
+declare const DEFAULT_SCATTER_MARKER_SIZE = 6;
+/** Minimum bubble radius (px) */
+declare const DEFAULT_MIN_BUBBLE_SIZE = 4;
+/** Maximum bubble radius (px) */
+declare const DEFAULT_MAX_BUBBLE_SIZE = 40;
+/** Scatter hit detection radius (px) */
+declare const DEFAULT_SCATTER_HIT_RADIUS = 10;
+/** Scatter/bubble fill opacity — overlap-aware default so dense clusters read as darker areas */
+declare const DEFAULT_SCATTER_FILL_OPACITY = 0.7;
+/** Scatter/bubble marker border width (px) — pairs with reduced fill opacity to keep isolated points crisp */
+declare const DEFAULT_SCATTER_BORDER_WIDTH = 1;
+/** Above this visible-point count per series, scatter hit-test builds a quadtree on first hover instead of linear-scanning */
+declare const SCATTER_SPATIAL_INDEX_THRESHOLD = 2000;
+/** When `boost === 'auto'`, scatter switches into boost mode at this visible-point count per series */
+declare const SCATTER_BOOST_AUTO_THRESHOLD = 50000;
+/** When `boost === 'auto'`, a line series batches its markers into merged paths at this point count */
+declare const LINE_BOOST_AUTO_THRESHOLD = 50000;
+/** Above this visible-point count per series, the SVG renderer warns once that canvas/decimation would scale better */
+declare const SCATTER_SVG_CEILING_WARNING = 10000;
+/** Above this visible element count, an SVG painter warns to prefer canvas/decimation (dev-only). */
+declare const SVG_ELEMENT_CEILING_WARNING = 8000;
+/** Radar fill opacity (0-1) */
+declare const DEFAULT_RADAR_FILL_OPACITY = 0.2;
+/** Radar hit detection radius (px) */
+declare const DEFAULT_RADAR_HIT_RADIUS = 15;
+/** Grid subdivision levels for radar/polar charts */
+declare const DEFAULT_GRID_LEVELS = 5;
+/** Radar/polar axis label font size (px) */
+declare const DEFAULT_RADIAL_LABEL_FONT_SIZE = 12;
+/** Gap between bars in polar charts (pixels — converted to degrees per category at render time using the outer radius) */
+declare const DEFAULT_POLAR_GAP_PX = 8;
+/** Candlestick up (bullish) color — light mode. Mirrors `--p-chart-positive` light. */
+declare const DEFAULT_CANDLESTICK_UP_COLOR = "#1eb854";
+/** Candlestick down (bearish) color — light mode. Mirrors `--p-chart-negative` light. */
+declare const DEFAULT_CANDLESTICK_DOWN_COLOR = "#dc2828";
+/** Candlestick neutral/doji color — light mode. Mirrors `--p-chart-candle-neutral` light. */
+declare const DEFAULT_CANDLESTICK_NEUTRAL_COLOR = "#6b7280";
+/** Candlestick wick stroke width (px) */
+declare const DEFAULT_CANDLESTICK_WICK_WIDTH = 1;
+/** Treemap cell padding (px) */
+declare const DEFAULT_TREEMAP_PADDING = 2;
+/** Treemap group label header height (px) */
+declare const DEFAULT_TREEMAP_GROUP_LABEL_HEIGHT = 18;
+/** Treemap default cell fill color — mirrors `--p-chart-treemap-cell` (Studio cobalt). */
+declare const DEFAULT_TREEMAP_CELL_COLOR = "#3563e9";
+/** Treemap header background color — mirrors `--p-chart-treemap-header-bg`. */
+declare const DEFAULT_TREEMAP_HEADER_BG = "rgba(0,0,0,0.6)";
+/** Treemap header text color — mirrors `--p-chart-treemap-header-text`. */
+declare const DEFAULT_TREEMAP_HEADER_TEXT_COLOR = "#FFFFFF";
+/** Treemap cell border color — mirrors `--p-chart-treemap-cell-border`. */
+declare const DEFAULT_TREEMAP_CELL_BORDER_COLOR = "rgba(0,0,0,0.15)";
+/** Default color palette for treemap groups — same Studio hexes as `--p-chart-color-N`. */
+declare const DEFAULT_TREEMAP_GROUP_COLORS: string[];
+/** Navigator vertical padding (px) */
+declare const DEFAULT_NAV_PADDING_Y = 4;
+/** Navigator horizontal padding (px) — prevents edge points from being clipped by rounded corners */
+declare const DEFAULT_NAV_PADDING_X = 6;
+/** Navigator minimum selection width (px) */
+declare const DEFAULT_NAV_MIN_SELECTION_WIDTH = 20;
+/** Navigator handle width (px) */
+declare const DEFAULT_NAV_HANDLE_WIDTH = 6;
+/** Navigator grip line gap (px) */
+declare const DEFAULT_NAV_GRIP_LINE_GAP = 3;
+/** Navigator visual defaults */
+declare const DEFAULT_NAV_STYLE: {
+    readonly height: 60;
+    readonly gap: 8;
+    readonly color: "#94a3b8";
+    readonly opacity: 0.3;
+    readonly selectionColor: "rgba(59,130,246,0.7)";
+    readonly selectionFill: "rgba(59,130,246,0.08)";
+    readonly maskColor: "rgba(0,0,0,0.12)";
+};
+/** Even-index category background fill */
+declare const DEFAULT_BG_FILL_EVEN = "rgba(0,0,0,0.03)";
+/** Odd-index category background fill */
+declare const DEFAULT_BG_FILL_ODD = "rgba(0,0,0,0.06)";
+/** Bracket tick mark size (px) */
+declare const DEFAULT_BRACKET_TICK_SIZE = 5;
+/** Gap between bracket line and axis (px) */
+declare const DEFAULT_BRACKET_GAP = 4;
+/** Height of each bracket nesting layer (px) */
+declare const DEFAULT_BRACKET_DEPTH_LAYER_SIZE = 24;
+/** Bracket label offset from bracket line (px) */
+declare const DEFAULT_BRACKET_LABEL_OFFSET = 6;
+/** Space reserved for axis title when brackets are present (px) */
+declare const DEFAULT_BRACKET_AXIS_TITLE_SPACE = 30;
+/** Padding between data point and its label (px) */
+declare const DEFAULT_LABEL_SPACING = 6;
+/** Gap between outermost tick label edge and axis title center (px) */
+declare const DEFAULT_TITLE_LABEL_GAP = 16;
+/** Fallback color for unresolved slice/bar colors */
+declare const DEFAULT_FALLBACK_COLOR = "#808080";
+/** Fallback border stroke color */
+declare const DEFAULT_BORDER_COLOR = "#000";
+/**
+ * Resolve a font size relative to the global base.
+ *
+ * Every text element has a default size (e.g. chart title = 16px, tick labels = 12px).
+ * When a user sets a global `fontSize` on the container, all elements scale proportionally:
+ *
+ *   resolvedSize = defaultPx / 12 * globalBase
+ *
+ * Examples with `fontSize={16}`:
+ *   - Tick labels (12px default) → 16px  (1.00×)
+ *   - Chart title (16px default) → 21px  (1.33×)
+ *   - Group labels (11px default) → 15px  (0.92×)
+ *
+ * When `globalFont` is undefined or has no `size`, returns `defaultPx` unchanged.
+ */
+declare function resolveFontSize(defaultPx: number, globalFont?: GlobalFont): number;
+/**
+ * Resolve the font family: explicit per-element → global override → default constant.
+ */
+declare function resolveFontFamily(elementFamily: string | undefined, globalFont?: GlobalFont): string;
+
+/**
+ * Merge a user-supplied partial theme onto the default light theme. Scalar
+ * fields shallow-merge; `series` merges **element-wise** so
+ * `theme={{ series: ['#ff0000'] }}` only changes color-0 and leaves 1–9 from
+ * the base. Pass `undefined` for an element to keep the base color.
+ *
+ * For dark-mode usage, callers should pass a partial that targets dark hexes
+ * (or pass `defaultDarkTheme` directly). The library does NOT auto-detect
+ * dark mode — that's the bridge utility's job in user-space (see canvas
+ * theming guide).
+ */
+declare function resolveTheme(userTheme: ChartTheme | undefined): Required<ChartTheme>;
+/**
+ * Resolve the color for a specific axis index from a resolved theme.
+ * Falls back to the first slot, then to a safe neutral so the return is always a string.
+ * Renderers should call this instead of indexing `theme.axes` directly to avoid
+ * `string | undefined` type errors when the slot is unset.
+ */
+declare function resolveAxisColor(theme: Required<ChartTheme>, index?: number): string;
+/**
+ * Expand a `ChartTheme` to inline-style CSS variables. Returns an object
+ * suitable for spreading into a Vue `:style` or React `style` prop on the
+ * chart container. Undefined / unset fields are skipped — the CSS class rules
+ * then resolve via the active `themes/*.css` token file.
+ */
+declare function themeToCssVars(theme: ChartTheme | undefined): Record<string, string>;
+/**
+ * Resolve background color, optionally detecting from DOM or dark mode.
+ * Useful for exports where 'auto' background should detect actual theme.
+ *
+ * @param container - Container element to walk up for background detection
+ * @param requestedBg - Requested background ('auto' for detection, or specific color)
+ * @returns Resolved background color
+ */
+declare function resolveBackgroundColor(container: HTMLElement, requestedBg: string): string;
+/**
+ * Calculate luminance of a color (0-255 scale).
+ * Uses the standard formula weighted for human perception.
+ *
+ * @param r - Red component (0-255)
+ * @param g - Green component (0-255)
+ * @param b - Blue component (0-255)
+ * @returns Luminance value (0-255)
+ */
+declare function calculateLuminance(r: number, g: number, b: number): number;
+/**
+ * Determine if a color is dark based on luminance.
+ *
+ * @param color - CSS color string (hex or rgb/rgba)
+ * @returns True if color is dark (luminance < 128)
+ */
+declare function isColorDark(color: string): boolean;
+
+export { DARK_MODE_COLORS, DEFAULT_ANNOTATION_COLOR, DEFAULT_ANNOTATION_COLOR_DARK, DEFAULT_AREA_FILL_OPACITY, DEFAULT_AXIS_COLOR, DEFAULT_AXIS_COLOR_DARK, DEFAULT_BG_FILL_EVEN, DEFAULT_BG_FILL_ODD, DEFAULT_BORDER_COLOR, DEFAULT_BRACKET_AXIS_TITLE_SPACE, DEFAULT_BRACKET_COLOR, DEFAULT_BRACKET_COLOR_DARK, DEFAULT_BRACKET_DEPTH_LAYER_SIZE, DEFAULT_BRACKET_GAP, DEFAULT_BRACKET_LABEL_OFFSET, DEFAULT_BRACKET_TICK_SIZE, DEFAULT_CANDLESTICK_DOWN_COLOR, DEFAULT_CANDLESTICK_NEUTRAL_COLOR, DEFAULT_CANDLESTICK_UP_COLOR, DEFAULT_CANDLESTICK_WICK_WIDTH, DEFAULT_CHART_CAPTION_COLOR, DEFAULT_CHART_CAPTION_COLOR_DARK, DEFAULT_CHART_CAPTION_FONT_SIZE, DEFAULT_CHART_CAPTION_PADDING, DEFAULT_CHART_PADDING, DEFAULT_CHART_TITLE_COLOR, DEFAULT_CHART_TITLE_COLOR_DARK, DEFAULT_CHART_TITLE_FONT_SIZE, DEFAULT_CHART_TITLE_PADDING, DEFAULT_CROSSHAIR_COLOR, DEFAULT_CROSSHAIR_COLOR_DARK, DEFAULT_DATA_LABEL_COLOR, DEFAULT_DATA_LABEL_COLOR_DARK, DEFAULT_DATA_LABEL_FONT_FAMILY, DEFAULT_DATA_LABEL_FONT_SIZE, DEFAULT_FALLBACK_COLOR, DEFAULT_FONT_FAMILY, DEFAULT_GRID_COLOR, DEFAULT_GRID_COLOR_DARK, DEFAULT_GRID_LEVELS, DEFAULT_GROUP_LABEL_COLOR, DEFAULT_GROUP_LABEL_COLOR_DARK, DEFAULT_GROUP_LABEL_FONT_SIZE, DEFAULT_GROUP_LABEL_FONT_WEIGHT, DEFAULT_HOVER_BRIGHTNESS, DEFAULT_HOVER_DIM_OPACITY, DEFAULT_HOVER_OFFSET, DEFAULT_HOVER_POINT_RADIUS_MULTIPLIER, DEFAULT_LABEL_PADDING, DEFAULT_LABEL_SPACING, DEFAULT_LEGEND_HEIGHT, DEFAULT_LEGEND_PADDING, DEFAULT_LEGEND_WIDTH, DEFAULT_LINE_MARKER_SIZE, DEFAULT_LINE_WIDTH, DEFAULT_MAX_BUBBLE_SIZE, DEFAULT_MIN_BUBBLE_SIZE, DEFAULT_NAV_GRIP_LINE_GAP, DEFAULT_NAV_HANDLE_WIDTH, DEFAULT_NAV_MIN_SELECTION_WIDTH, DEFAULT_NAV_PADDING_X, DEFAULT_NAV_PADDING_Y, DEFAULT_NAV_STYLE, DEFAULT_POLAR_GAP_PX, DEFAULT_RADAR_FILL_OPACITY, DEFAULT_RADAR_HIT_RADIUS, DEFAULT_RADIAL_LABEL_FONT_SIZE, DEFAULT_REFERENCE_BAND_FILL, DEFAULT_REFERENCE_BAND_OPACITY, DEFAULT_REFERENCE_LABEL_FONT_SIZE, DEFAULT_REFERENCE_LABEL_FONT_WEIGHT, DEFAULT_REFERENCE_LABEL_OFFSET, DEFAULT_REFERENCE_LINE_STROKE, DEFAULT_REFERENCE_LINE_WIDTH, DEFAULT_SCATTER_BORDER_WIDTH, DEFAULT_SCATTER_FILL_OPACITY, DEFAULT_SCATTER_HIT_RADIUS, DEFAULT_SCATTER_MARKER_SIZE, DEFAULT_TICK_FONT_SIZE, DEFAULT_TICK_LABEL_COLOR, DEFAULT_TICK_LABEL_COLOR_DARK, DEFAULT_TICK_LENGTH, DEFAULT_TITLE_FONT_SIZE, DEFAULT_TITLE_LABEL_GAP, DEFAULT_TITLE_OFFSET, DEFAULT_TREEMAP_CELL_BORDER_COLOR, DEFAULT_TREEMAP_CELL_COLOR, DEFAULT_TREEMAP_GROUP_COLORS, DEFAULT_TREEMAP_GROUP_LABEL_HEIGHT, DEFAULT_TREEMAP_HEADER_BG, DEFAULT_TREEMAP_HEADER_TEXT_COLOR, DEFAULT_TREEMAP_PADDING, LIGHT_MODE_COLORS, LINE_BOOST_AUTO_THRESHOLD, SCATTER_BOOST_AUTO_THRESHOLD, SCATTER_SPATIAL_INDEX_THRESHOLD, SCATTER_SVG_CEILING_WARNING, SVG_ELEMENT_CEILING_WARNING, calculateLuminance, isColorDark, resolveAxisColor, resolveBackgroundColor, resolveFontFamily, resolveFontSize, resolveTheme, themeToCssVars };

package/dist/utils/theme/index.mjs

@@ -0,0 +1,5 @@
+export { DARK_MODE_COLORS, DEFAULT_ANNOTATION_COLOR, DEFAULT_ANNOTATION_COLOR_DARK, DEFAULT_AREA_FILL_OPACITY, DEFAULT_AXIS_COLOR, DEFAULT_AXIS_COLOR_DARK, DEFAULT_BG_FILL_EVEN, DEFAULT_BG_FILL_ODD, DEFAULT_BORDER_COLOR, DEFAULT_BRACKET_AXIS_TITLE_SPACE, DEFAULT_BRACKET_COLOR, DEFAULT_BRACKET_COLOR_DARK, DEFAULT_BRACKET_DEPTH_LAYER_SIZE, DEFAULT_BRACKET_GAP, DEFAULT_BRACKET_LABEL_OFFSET, DEFAULT_BRACKET_TICK_SIZE, DEFAULT_CANDLESTICK_DOWN_COLOR, DEFAULT_CANDLESTICK_NEUTRAL_COLOR, DEFAULT_CANDLESTICK_UP_COLOR, DEFAULT_CANDLESTICK_WICK_WIDTH, DEFAULT_CHART_CAPTION_COLOR, DEFAULT_CHART_CAPTION_COLOR_DARK, DEFAULT_CHART_CAPTION_FONT_SIZE, DEFAULT_CHART_CAPTION_PADDING, DEFAULT_CHART_PADDING, DEFAULT_CHART_TITLE_COLOR, DEFAULT_CHART_TITLE_COLOR_DARK, DEFAULT_CHART_TITLE_FONT_SIZE, DEFAULT_CHART_TITLE_PADDING, DEFAULT_CROSSHAIR_COLOR, DEFAULT_CROSSHAIR_COLOR_DARK, DEFAULT_DATA_LABEL_COLOR, DEFAULT_DATA_LABEL_COLOR_DARK, DEFAULT_DATA_LABEL_FONT_FAMILY, DEFAULT_DATA_LABEL_FONT_SIZE, DEFAULT_FALLBACK_COLOR, DEFAULT_FONT_FAMILY, DEFAULT_GRID_COLOR, DEFAULT_GRID_COLOR_DARK, DEFAULT_GRID_LEVELS, DEFAULT_GROUP_LABEL_COLOR, DEFAULT_GROUP_LABEL_COLOR_DARK, DEFAULT_GROUP_LABEL_FONT_SIZE, DEFAULT_GROUP_LABEL_FONT_WEIGHT, DEFAULT_HOVER_BRIGHTNESS, DEFAULT_HOVER_DIM_OPACITY, DEFAULT_HOVER_OFFSET, DEFAULT_HOVER_POINT_RADIUS_MULTIPLIER, DEFAULT_LABEL_PADDING, DEFAULT_LABEL_SPACING, DEFAULT_LEGEND_HEIGHT, DEFAULT_LEGEND_PADDING, DEFAULT_LEGEND_WIDTH, DEFAULT_LINE_MARKER_SIZE, DEFAULT_LINE_WIDTH, DEFAULT_MAX_BUBBLE_SIZE, DEFAULT_MIN_BUBBLE_SIZE, DEFAULT_NAV_GRIP_LINE_GAP, DEFAULT_NAV_HANDLE_WIDTH, DEFAULT_NAV_MIN_SELECTION_WIDTH, DEFAULT_NAV_PADDING_X, DEFAULT_NAV_PADDING_Y, DEFAULT_NAV_STYLE, DEFAULT_POLAR_GAP_PX, DEFAULT_RADAR_FILL_OPACITY, DEFAULT_RADAR_HIT_RADIUS, DEFAULT_RADIAL_LABEL_FONT_SIZE, DEFAULT_REFERENCE_BAND_FILL, DEFAULT_REFERENCE_BAND_OPACITY, DEFAULT_REFERENCE_LABEL_FONT_SIZE, DEFAULT_REFERENCE_LABEL_FONT_WEIGHT, DEFAULT_REFERENCE_LABEL_OFFSET, DEFAULT_REFERENCE_LINE_STROKE, DEFAULT_REFERENCE_LINE_WIDTH, DEFAULT_SCATTER_BORDER_WIDTH, DEFAULT_SCATTER_FILL_OPACITY, DEFAULT_SCATTER_HIT_RADIUS, DEFAULT_SCATTER_MARKER_SIZE, DEFAULT_TICK_FONT_SIZE, DEFAULT_TICK_LABEL_COLOR, DEFAULT_TICK_LABEL_COLOR_DARK, DEFAULT_TICK_LENGTH, DEFAULT_TITLE_FONT_SIZE, DEFAULT_TITLE_LABEL_GAP, DEFAULT_TITLE_OFFSET, DEFAULT_TREEMAP_CELL_BORDER_COLOR, DEFAULT_TREEMAP_CELL_COLOR, DEFAULT_TREEMAP_GROUP_COLORS, DEFAULT_TREEMAP_GROUP_LABEL_HEIGHT, DEFAULT_TREEMAP_HEADER_BG, DEFAULT_TREEMAP_HEADER_TEXT_COLOR, DEFAULT_TREEMAP_PADDING, LIGHT_MODE_COLORS, LINE_BOOST_AUTO_THRESHOLD, SCATTER_BOOST_AUTO_THRESHOLD, SCATTER_SPATIAL_INDEX_THRESHOLD, SCATTER_SVG_CEILING_WARNING, SVG_ELEMENT_CEILING_WARNING, calculateLuminance, isColorDark, resolveAxisColor, resolveBackgroundColor, resolveFontFamily, resolveFontSize, resolveTheme, themeToCssVars } from '../../chunk-NKUYIWAP.mjs';
+import '../../chunk-QS76E3TD.mjs';
+import '../../chunk-O2X6FF45.mjs';
+import '../../chunk-SSLTFJ3U.mjs';
+import '../../chunk-RQ3CKQOX.mjs';

package/dist/utils/zoom/index.d.mts

@@ -0,0 +1,90 @@
+import { CartesianLayoutData, ZoomState, LinearScale, ZoomAxisWindow, ZoomLimits, ModifierKey } from '@primeui/chart-types';
+export { Z as ZoomPanController } from '../../controller-BoNigQJr.mjs';
+
+/**
+ * Clamp a zoom window to limits.
+ * Enforces: hard min/max bounds and minimum range (max zoom depth).
+ *
+ * When originalDomain is provided, it acts as implicit hard bounds —
+ * the user can never zoom out beyond the original data extent, and
+ * an automatic minRange (originalRange / 20) prevents over-zoom-in.
+ */
+declare function clampZoomWindow(window: ZoomAxisWindow, limits?: ZoomLimits, originalDomain?: [number, number]): ZoomAxisWindow;
+/**
+ * Compute new domain after wheel zoom, centered on cursor position.
+ * zoomFactor > 1 = zoom in, < 1 = zoom out.
+ *
+ * The cursor position stays at the same data value — the domain
+ * contracts or expands around it proportionally.
+ */
+declare function computeWheelZoom(currentWindow: ZoomAxisWindow, cursorDataValue: number, zoomFactor: number, limits?: ZoomLimits, originalDomain?: [number, number]): ZoomAxisWindow;
+/**
+ * Classify a wheel event as a zoom or a pan gesture.
+ *
+ * The browser folds three physically different inputs into one `wheel` event:
+ *   - mouse wheel         → vertical deltas (any granularity, no horizontal)
+ *   - trackpad pinch      → pixel deltas with `ctrlKey` set synthetically by the browser
+ *   - trackpad two-finger → pixel deltas, with a horizontal component when scrolling sideways
+ *
+ * Only a horizontal component (`deltaX`) reliably distinguishes a trackpad from a
+ * mouse, so that is the sole pan signal. A pure-vertical wheel/scroll always zooms —
+ * this keeps mouse-wheel zoom working regardless of how fine-grained the mouse's
+ * deltas are. The tradeoff is that vertical two-finger trackpad scroll zooms rather
+ * than pans; horizontal two-finger scroll (the natural pan gesture) and pinch still
+ * behave as expected.
+ */
+declare function classifyWheelGesture(e: {
+    deltaX: number;
+    deltaY: number;
+    ctrlKey: boolean;
+}): 'zoom' | 'pan';
+/**
+ * Compute domain from drag selection rectangle.
+ * Converts two pixel positions to data values via scale.invert().
+ */
+declare function computeDragZoomWindow(startPixel: number, endPixel: number, invert: (px: number) => number, limits?: ZoomLimits, originalDomain?: [number, number]): ZoomAxisWindow;
+/**
+ * Compute domain after pan by pixel delta.
+ * Shifts the window by converting pixel delta to data delta.
+ */
+declare function computePanDelta(currentWindow: ZoomAxisWindow, deltaPixels: number, pixelRange: number, limits?: ZoomLimits, originalDomain?: [number, number]): ZoomAxisWindow;
+/**
+ * Check if a zoom state represents any zoom (differs from null/unzoomed).
+ */
+declare function isZoomed(state: ZoomState): boolean;
+/**
+ * Normalize a zoom state by snapping axis windows that match the full
+ * original domain to `null`. Lets `isZoomed()` return false (and UI like
+ * the Reset button / navigator selection disappear) after a wheel/drag
+ * zoom-out that reaches the original extent.
+ */
+declare function normalizeZoomState(state: ZoomState, originals: {
+    x?: [number, number];
+    y?: [number, number];
+}): ZoomState;
+/**
+ * Check if a modifier key is currently pressed.
+ */
+declare function isModifierKeyPressed(e: {
+    shiftKey: boolean;
+    ctrlKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+}, key?: ModifierKey): boolean;
+/** Create a default (unzoomed) state */
+declare function createInitialZoomState(): ZoomState;
+/** Normalize boolean | config shorthand into a config object, merging with defaults */
+declare function normalizeSubConfig<T extends object>(value: boolean | T | undefined, defaults: T): T | null;
+/** Merge data-aware minRange from layout into user-specified zoom limits */
+declare function effectiveLimit(userLimit: ZoomLimits | undefined, dataMinRange: number | undefined): ZoomLimits | undefined;
+/**
+ * Build x/y LinearScales from layout data for the zoom system to use with invert().
+ * For category axes (no time/scatter), synthesizes an index-based linear scale aligned
+ * to actual band midpoints so pixel → category index conversion is accurate.
+ */
+declare function buildZoomScales(layoutData: CartesianLayoutData, zoomState: ZoomState | null | undefined): {
+    x?: LinearScale;
+    y?: LinearScale;
+};
+
+export { buildZoomScales, clampZoomWindow, classifyWheelGesture, computeDragZoomWindow, computePanDelta, computeWheelZoom, createInitialZoomState, effectiveLimit, isModifierKeyPressed, isZoomed, normalizeSubConfig, normalizeZoomState };

package/dist/utils/zoom/index.mjs

@@ -0,0 +1,3 @@
+import '../../chunk-ADKLH73T.mjs';
+export { ZoomPanController, buildZoomScales, clampZoomWindow, classifyWheelGesture, computeDragZoomWindow, computePanDelta, computeWheelZoom, createInitialZoomState, effectiveLimit, isModifierKeyPressed, isZoomed, normalizeSubConfig, normalizeZoomState } from '../../chunk-WRULPWHD.mjs';
+import '../../chunk-RQ3CKQOX.mjs';

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@primeui/chart-core",
+  "version": "0.0.1-alpha.1",
+  "author": "PrimeTek Informatics",
+  "description": "Chart API for PrimeUI.",
+  "keywords": [
+    "chart",
+    "primeui"
+  ],
+  "license": "SEE LICENSE IN LICENSE.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/primefaces/primeui.git",
+    "directory": "packages/components/chart/chart-core"
+  },
+  "bugs": {
+    "url": "https://github.com/primefaces/primeui/issues"
+  },
+  "main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./*": {
+      "types": "./dist/*/index.d.mts",
+      "import": "./dist/*/index.mjs",
+      "default": "./dist/*/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@primeui/chart-types": "0.0.1-alpha.1",
+    "@primeui/core": "0.0.1-alpha.1"
+  },
+  "scripts": {
+    "build": "cross-env NODE_ENV=production INPUT_DIR=src/ OUTPUT_DIR=dist/ pnpm run build:package",
+    "build:dev": "cross-env NODE_ENV=development INPUT_DIR=src/ OUTPUT_DIR=dist/ pnpm run build:dev:package",
+    "build:package": "cross-env NODE_ENV=test pnpm run test && cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=8192 tsup",
+    "build:dev:package": "tsup --watch",
+    "type:check": "tsc --noEmit",
+    "test": "vitest run --root ../../../.. chart-core",
+    "dev:link": "pnpm link --global && npm link"
+  },
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts"
+}