@tetrascience-npm/tetrascience-react-ui 0.7.0 → 1.0.0

package/dist/components/charts/ScatterPlotInteractive/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sources":["../../../../src/components/charts/ScatterPlotInteractive/utils.ts"],"sourcesContent":["import {\n  COLORS,\n  DEFAULT_CATEGORY_COLORS,\n  DEFAULT_MAX_POINTS,\n  DEFAULT_MARKER_SIZE,\n  DEFAULT_SIZE_RANGE,\n  PLOT_CONSTANTS,\n} from \"./constants\";\n\nimport type {\n  AxisConfig,\n  ColorMapping,\n  DownsamplingConfig,\n  ScatterPoint,\n  SelectionMode,\n  ShapeMapping,\n  SizeMapping,\n} from \"./types\";\nimport type { PlotlyThemeColors } from \"@/hooks/use-plotly-theme\";\n\n/**\n * Calculate min and max values for a numeric field in the data\n */\nexport function calculateRange(data: ScatterPoint[], field: string): { min: number; max: number } {\n  let min = Number.POSITIVE_INFINITY;\n  let max = Number.NEGATIVE_INFINITY;\n\n  for (const point of data) {\n    const value = point.metadata?.[field];\n    if (typeof value === \"number\" && Number.isFinite(value)) {\n      min = Math.min(min, value);\n      max = Math.max(max, value);\n    }\n  }\n\n  // Handle edge case where all values are invalid\n  if (!Number.isFinite(min) || !Number.isFinite(max)) {\n    return { min: 0, max: 1 };\n  }\n\n  // Handle edge case where min === max\n  if (min === max) {\n    return { min: min - 1, max: max + 1 };\n  }\n\n  return { min, max };\n}\n\n/**\n * Get unique categorical values from a field\n */\nexport function getUniqueCategories(data: ScatterPoint[], field: string): string[] {\n  const uniqueCategories = data\n    .map((point) => point.metadata?.[field])\n    .filter((value): value is string => typeof value === \"string\");\n\n  return [...new Set(uniqueCategories)].sort();\n}\n\n/**\n * Map colors based on color mapping configuration\n */\nexport function mapColors(data: ScatterPoint[], colorMapping?: ColorMapping): string[] {\n  if (!colorMapping || colorMapping.type === \"static\") {\n    const color = colorMapping?.value || COLORS.primary;\n    return new Array(data.length).fill(color);\n  }\n\n  if (colorMapping.type === \"categorical\" && colorMapping.field) {\n    const categories = getUniqueCategories(data, colorMapping.field);\n    const colorMap = colorMapping.categoryColors || {};\n\n    // Assign default colors to categories without explicit colors\n    const categoryColorMap: Record<string, string> = {};\n    categories.forEach((category, index) => {\n      categoryColorMap[category] =\n        colorMap[category] || DEFAULT_CATEGORY_COLORS[index % DEFAULT_CATEGORY_COLORS.length];\n    });\n\n    return data.map((point) => {\n      const value = point.metadata?.[colorMapping.field!];\n      return categoryColorMap[String(value)] || DEFAULT_CATEGORY_COLORS[0];\n    });\n  }\n\n  return new Array(data.length).fill(COLORS.primary);\n}\n\n/**\n * Map shapes based on shape mapping configuration\n */\nexport function mapShapes(data: ScatterPoint[], shapeMapping?: ShapeMapping): string[] {\n  if (!shapeMapping || shapeMapping.type === \"static\") {\n    const shape = shapeMapping?.value || \"circle\";\n    return new Array(data.length).fill(shape);\n  }\n\n  if (shapeMapping.type === \"categorical\" && shapeMapping.field) {\n    const categories = getUniqueCategories(data, shapeMapping.field);\n    const shapeMap = shapeMapping.categoryShapes || {};\n    const defaultShapes = [\"circle\", \"square\", \"diamond\", \"cross\", \"x\", \"triangle-up\", \"triangle-down\", \"star\"];\n\n    // Assign default shapes to categories without explicit shapes\n    const categoryShapeMap: Record<string, string> = {};\n    categories.forEach((category, index) => {\n      categoryShapeMap[category] = shapeMap[category] || defaultShapes[index % defaultShapes.length];\n    });\n\n    return data.map((point) => {\n      const value = point.metadata?.[shapeMapping.field!];\n      return categoryShapeMap[String(value)] || \"circle\";\n    });\n  }\n\n  return new Array(data.length).fill(\"circle\");\n}\n\n/**\n * Map sizes based on size mapping configuration\n */\nexport function mapSizes(data: ScatterPoint[], sizeMapping?: SizeMapping): number[] {\n  if (!sizeMapping || sizeMapping.type === \"static\") {\n    const size = sizeMapping?.value || DEFAULT_MARKER_SIZE;\n    return new Array(data.length).fill(size);\n  }\n\n  if (sizeMapping.type === \"categorical\" && sizeMapping.field) {\n    const categories = getUniqueCategories(data, sizeMapping.field);\n    const sizeMap = sizeMapping.categorySizes || {};\n\n    // Assign default sizes to categories without explicit sizes\n    const categorySizeMap: Record<string, number> = {};\n    categories.forEach((category, index) => {\n      categorySizeMap[category] = sizeMap[category] || DEFAULT_MARKER_SIZE + index * 2;\n    });\n\n    return data.map((point) => {\n      const value = point.metadata?.[sizeMapping.field!];\n      return categorySizeMap[String(value)] || DEFAULT_MARKER_SIZE;\n    });\n  }\n\n  if (sizeMapping.type === \"continuous\" && sizeMapping.field) {\n    const range =\n      sizeMapping.min !== undefined && sizeMapping.max !== undefined\n        ? { min: sizeMapping.min, max: sizeMapping.max }\n        : calculateRange(data, sizeMapping.field);\n\n    const sizeRange = sizeMapping.sizeRange || DEFAULT_SIZE_RANGE;\n    const [minSize, maxSize] = sizeRange;\n\n    return data.map((point) => {\n      const value = point.metadata?.[sizeMapping.field!];\n      if (typeof value === \"number\" && Number.isFinite(value)) {\n        // Normalize and map to size range\n        const normalized = (value - range.min) / (range.max - range.min);\n        return minSize + normalized * (maxSize - minSize);\n      }\n      return DEFAULT_MARKER_SIZE;\n    });\n  }\n\n  return new Array(data.length).fill(DEFAULT_MARKER_SIZE);\n}\n\n/**\n * Downsample data using specified strategy\n */\nexport function downsampleData(data: ScatterPoint[], config: DownsamplingConfig): ScatterPoint[] {\n  if (!config.enabled || data.length <= (config.maxPoints || DEFAULT_MAX_POINTS)) {\n    return data;\n  }\n\n  const maxPoints = config.maxPoints || DEFAULT_MAX_POINTS;\n  const strategy = config.strategy || \"lttb\";\n\n  if (strategy === \"lttb\") {\n    // Largest Triangle Three Buckets algorithm\n    return lttbDownsample(data, maxPoints);\n  }\n\n  return data;\n}\n\n/**\n * Compute the (x, y) centroid of data[start..end).\n * Falls back to the point at clamp(start, 0, dataLength-1) when the range is\n * empty (only reachable under extreme floating-point drift) to prevent NaN.\n */\nfunction bucketCentroid(\n  data: ScatterPoint[],\n  start: number,\n  end: number,\n  dataLength: number,\n): { x: number; y: number } {\n  const length = end - start;\n  if (length > 0) {\n    let sumX = 0;\n    let sumY = 0;\n    for (let j = start; j < end; j++) {\n      sumX += data[j].x;\n      sumY += data[j].y;\n    }\n    return { x: sumX / length, y: sumY / length };\n  }\n  const fallbackIdx = Math.max(0, Math.min(start, dataLength - 1));\n  return { x: data[fallbackIdx].x, y: data[fallbackIdx].y };\n}\n\n/**\n * Largest Triangle Three Buckets (LTTB) downsampling algorithm.\n * Preserves the visual shape of the data by maximizing the triangle area\n * formed by adjacent bucket centroids and each candidate point.\n * Exported for unit testing\n */\nexport function lttbDownsample(data: ScatterPoint[], threshold: number): ScatterPoint[] {\n  const dataLength = data.length;\n\n  // --- Edge cases ---\n  if (threshold <= 0 || dataLength === 0) return [];\n  // No downsampling needed; return the original reference unchanged.\n  if (threshold >= dataLength) return data;\n  if (threshold === 1) return [data[0]];\n  if (threshold === 2) return [data[0], data[dataLength - 1]];\n\n  // At this point: 3 <= threshold < dataLength, so dataLength >= 4.\n  // Spread (dataLength - 2) interior points across (threshold - 2) buckets,\n  // keeping the first and last points fixed outside the buckets.\n  // With threshold < dataLength, every > 1, so no bucket is ever empty.\n  const every = (dataLength - 2) / (threshold - 2);\n\n  const { floor, abs, min } = Math;\n  const sampled: ScatterPoint[] = [data[0]];\n\n  // Index of the previously selected point — left vertex A of the triangle.\n  let a = 0;\n\n  for (let i = 0; i < threshold - 2; i++) {\n    // Centroid of the *next* bucket — right vertex C of the triangle.\n    // Biases candidate selection toward points that preserve visual variance.\n    const avgRangeStart = min(floor((i + 1) * every) + 1, dataLength - 1);\n    const avgRangeEnd = min(floor((i + 2) * every) + 1, dataLength);\n    const { x: avgX, y: avgY } = bucketCentroid(data, avgRangeStart, avgRangeEnd, dataLength);\n\n    // Boundaries of the current bucket — middle vertex B candidates.\n    // Clamped to valid index range to guard against floating-point drift.\n    const rangeStart = min(floor(i * every) + 1, dataLength - 1);\n    const rangeEnd = min(floor((i + 1) * every) + 1, dataLength - 1);\n\n    const pointAX = data[a].x;\n    const pointAY = data[a].y;\n\n    // Safe fallback: first point in the bucket, used when the bucket is degenerate.\n    let maxArea = -1;\n    let maxAreaPoint: ScatterPoint = data[rangeStart];\n    let nextA = rangeStart;\n\n    for (let j = rangeStart; j < rangeEnd; j++) {\n      // Area of the triangle formed by A (prev selected), B (candidate), C (next centroid).\n      // The point maximising this area is the most visually significant in the bucket.\n      const area = abs((pointAX - avgX) * (data[j].y - pointAY) - (pointAX - data[j].x) * (avgY - pointAY)) * 0.5;\n      if (area > maxArea) {\n        maxArea = area;\n        maxAreaPoint = data[j];\n        nextA = j;\n      }\n    }\n\n    sampled.push(maxAreaPoint);\n    a = nextA;\n  }\n\n  sampled.push(data[dataLength - 1]); // Always include the last point.\n\n  return sampled;\n}\n\n/**\n * Generate default tooltip content\n */\nexport function generateTooltipContent(point: ScatterPoint, fields?: string[]): string {\n  const lines: string[] = [];\n\n  // Always include x, y\n  lines.push(`X: ${point.x.toFixed(2)}`);\n  lines.push(`Y: ${point.y.toFixed(2)}`);\n\n  // Add label if present\n  if (point.label) {\n    lines.push(`Label: ${point.label}`);\n  }\n\n  // Add requested fields from metadata\n  if (fields && point.metadata) {\n    for (const field of fields) {\n      if (field in point.metadata) {\n        const value = point.metadata[field];\n        lines.push(`${field}: ${value}`);\n      }\n    }\n  } else if (point.metadata && !fields) {\n    // If no fields specified, show all metadata\n    for (const [key, value] of Object.entries(point.metadata)) {\n      lines.push(`${key}: ${value}`);\n    }\n  }\n\n  return lines.join(\"<br>\");\n}\n\n/**\n * Determine selection mode from keyboard event\n */\nexport function getSelectionMode(event: { shiftKey: boolean; ctrlKey: boolean; metaKey: boolean }): SelectionMode {\n  const ctrlOrCmd = event.ctrlKey || event.metaKey;\n\n  if (event.shiftKey && ctrlOrCmd) {\n    return \"toggle\";\n  }\n  if (event.shiftKey) {\n    return \"add\";\n  }\n  if (ctrlOrCmd) {\n    return \"remove\";\n  }\n  return \"replace\";\n}\n\n/**\n * Calculate axis range with padding.\n *\n * When `scale` is `\"log\"`, the returned range is in log10 units (what Plotly\n * expects for `type: \"log\"` axes), and padding is applied in log-space so that\n * the visual margin is proportional on the logarithmic axis.\n */\nexport function calculateAxisRange(\n  data: ScatterPoint[],\n  axis: \"x\" | \"y\",\n  padding = 0.1,\n  scale: \"linear\" | \"log\" = \"linear\",\n): [number, number] {\n  const isLog = scale === \"log\";\n  let min = Infinity;\n  let max = -Infinity;\n\n  for (const point of data) {\n    const v = point[axis];\n    if (!Number.isFinite(v)) continue;\n    // log10 is undefined for non-positive values — skip them silently\n    if (isLog && v <= 0) continue;\n    // Plotly log axes expect range bounds in log10 units\n    const mapped = isLog ? Math.log10(v) : v;\n    if (mapped < min) min = mapped;\n    if (mapped > max) max = mapped;\n  }\n\n  if (!Number.isFinite(min)) {\n    return [0, 1];\n  }\n\n  if (min === max) {\n    return [min - 1, max + 1];\n  }\n\n  const range = max - min;\n  return [min - range * padding, max + range * padding];\n}\n\n/**\n * Apply selection to a set of point IDs\n */\nexport function applySelection(\n  currentSelection: Set<string | number>,\n  newIds: Set<string | number>,\n  mode: SelectionMode,\n): Set<string | number> {\n  const result = new Set(currentSelection);\n\n  switch (mode) {\n    case \"replace\":\n      return new Set(newIds);\n\n    case \"add\":\n      for (const id of newIds) {\n        result.add(id);\n      }\n      return result;\n\n    case \"remove\":\n      for (const id of newIds) {\n        result.delete(id);\n      }\n      return result;\n\n    case \"toggle\":\n      for (const id of newIds) {\n        if (result.has(id)) {\n          result.delete(id);\n        } else {\n          result.add(id);\n        }\n      }\n      return result;\n\n    default:\n      return result;\n  }\n}\n\nexport const getPlotlyLayoutConfig = ({\n  title,\n  xAxis,\n  yAxis,\n  width,\n  height,\n  xRange,\n  yRange,\n  enableLassoSelection,\n  enableBoxSelection,\n  theme,\n}: {\n  title: string | undefined;\n  xAxis: AxisConfig;\n  yAxis: AxisConfig;\n  width: number;\n  height: number;\n  xRange: [number, number] | undefined;\n  yRange: [number, number] | undefined;\n  enableLassoSelection: boolean;\n  enableBoxSelection: boolean;\n  theme: PlotlyThemeColors;\n}): Partial<Plotly.Layout> => ({\n  autosize: false,\n  width,\n  height,\n  title: title\n    ? {\n        text: title,\n        font: {\n          family: PLOT_CONSTANTS.FONT_FAMILY,\n          size: PLOT_CONSTANTS.TITLE_FONT_SIZE,\n          color: theme.textColor,\n        },\n        x: 0.5,\n        xanchor: \"center\",\n      }\n    : undefined,\n  margin: {\n    l: PLOT_CONSTANTS.MARGIN_LEFT,\n    r: PLOT_CONSTANTS.MARGIN_RIGHT,\n    t: title ? PLOT_CONSTANTS.MARGIN_TOP : PLOT_CONSTANTS.MARGIN_TOP - PLOT_CONSTANTS.TITLE_FONT_SIZE,\n    b: PLOT_CONSTANTS.MARGIN_BOTTOM,\n  },\n  xaxis: {\n    title: {\n      text: xAxis.title || \"\",\n      font: {\n        family: PLOT_CONSTANTS.FONT_FAMILY,\n        size: PLOT_CONSTANTS.AXIS_TITLE_FONT_SIZE,\n        color: theme.textSecondary,\n      },\n    },\n    type: xAxis.scale === \"log\" ? \"log\" : \"linear\",\n    range: xRange,\n    autorange: !xRange,\n    gridcolor: theme.gridColor,\n    linecolor: theme.lineColor,\n    linewidth: PLOT_CONSTANTS.AXIS_LINE_WIDTH,\n    tickfont: {\n      family: PLOT_CONSTANTS.FONT_FAMILY,\n      size: PLOT_CONSTANTS.AXIS_TICK_FONT_SIZE,\n      color: theme.textColor,\n    },\n    zeroline: false,\n  },\n  yaxis: {\n    title: {\n      text: yAxis.title || \"\",\n      font: {\n        family: PLOT_CONSTANTS.FONT_FAMILY,\n        size: PLOT_CONSTANTS.AXIS_TITLE_FONT_SIZE,\n        color: theme.textSecondary,\n      },\n    },\n    type: yAxis.scale === \"log\" ? \"log\" : \"linear\",\n    range: yRange,\n    autorange: !yRange,\n    gridcolor: theme.gridColor,\n    linecolor: theme.lineColor,\n    linewidth: PLOT_CONSTANTS.AXIS_LINE_WIDTH,\n    tickfont: {\n      family: PLOT_CONSTANTS.FONT_FAMILY,\n      size: PLOT_CONSTANTS.AXIS_TICK_FONT_SIZE,\n      color: theme.textColor,\n    },\n    zeroline: false,\n  },\n  paper_bgcolor: theme.paperBg,\n  plot_bgcolor: theme.plotBg,\n  font: {\n    family: PLOT_CONSTANTS.FONT_FAMILY,\n    color: theme.textColor,\n  },\n  hovermode: \"closest\",\n  dragmode: enableLassoSelection ? \"lasso\" : enableBoxSelection ? \"select\" : false,\n});\n"],"names":["calculateRange","data","field","min","max","point","value","getUniqueCategories","uniqueCategories","mapColors","colorMapping","color","COLORS","categories","colorMap","categoryColorMap","category","index","DEFAULT_CATEGORY_COLORS","mapShapes","shapeMapping","shape","shapeMap","defaultShapes","categoryShapeMap","mapSizes","sizeMapping","size","DEFAULT_MARKER_SIZE","sizeMap","categorySizeMap","range","sizeRange","DEFAULT_SIZE_RANGE","minSize","maxSize","normalized","downsampleData","config","DEFAULT_MAX_POINTS","maxPoints","lttbDownsample","bucketCentroid","start","end","dataLength","length","sumX","sumY","j","fallbackIdx","threshold","every","floor","abs","sampled","a","i","avgRangeStart","avgRangeEnd","avgX","avgY","rangeStart","rangeEnd","pointAX","pointAY","maxArea","maxAreaPoint","nextA","area","generateTooltipContent","fields","lines","key","getSelectionMode","event","ctrlOrCmd","calculateAxisRange","axis","padding","scale","isLog","v","mapped","applySelection","currentSelection","newIds","mode","result","id","getPlotlyLayoutConfig","title","xAxis","yAxis","width","height","xRange","yRange","enableLassoSelection","enableBoxSelection","theme","PLOT_CONSTANTS"],"mappings":"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"}

package/dist/components/charts/ScatterPlotInteractive/utils.d.ts

@@ -0,0 +1,72 @@
+import { AxisConfig, ColorMapping, DownsamplingConfig, ScatterPoint, SelectionMode, ShapeMapping, SizeMapping } from './types';
+import { PlotlyThemeColors } from '../../../hooks/use-plotly-theme';
+/**
+ * Calculate min and max values for a numeric field in the data
+ */
+export declare function calculateRange(data: ScatterPoint[], field: string): {
+    min: number;
+    max: number;
+};
+/**
+ * Get unique categorical values from a field
+ */
+export declare function getUniqueCategories(data: ScatterPoint[], field: string): string[];
+/**
+ * Map colors based on color mapping configuration
+ */
+export declare function mapColors(data: ScatterPoint[], colorMapping?: ColorMapping): string[];
+/**
+ * Map shapes based on shape mapping configuration
+ */
+export declare function mapShapes(data: ScatterPoint[], shapeMapping?: ShapeMapping): string[];
+/**
+ * Map sizes based on size mapping configuration
+ */
+export declare function mapSizes(data: ScatterPoint[], sizeMapping?: SizeMapping): number[];
+/**
+ * Downsample data using specified strategy
+ */
+export declare function downsampleData(data: ScatterPoint[], config: DownsamplingConfig): ScatterPoint[];
+/**
+ * Largest Triangle Three Buckets (LTTB) downsampling algorithm.
+ * Preserves the visual shape of the data by maximizing the triangle area
+ * formed by adjacent bucket centroids and each candidate point.
+ * Exported for unit testing
+ */
+export declare function lttbDownsample(data: ScatterPoint[], threshold: number): ScatterPoint[];
+/**
+ * Generate default tooltip content
+ */
+export declare function generateTooltipContent(point: ScatterPoint, fields?: string[]): string;
+/**
+ * Determine selection mode from keyboard event
+ */
+export declare function getSelectionMode(event: {
+    shiftKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+}): SelectionMode;
+/**
+ * Calculate axis range with padding.
+ *
+ * When `scale` is `"log"`, the returned range is in log10 units (what Plotly
+ * expects for `type: "log"` axes), and padding is applied in log-space so that
+ * the visual margin is proportional on the logarithmic axis.
+ */
+export declare function calculateAxisRange(data: ScatterPoint[], axis: "x" | "y", padding?: number, scale?: "linear" | "log"): [number, number];
+/**
+ * Apply selection to a set of point IDs
+ */
+export declare function applySelection(currentSelection: Set<string | number>, newIds: Set<string | number>, mode: SelectionMode): Set<string | number>;
+export declare const getPlotlyLayoutConfig: ({ title, xAxis, yAxis, width, height, xRange, yRange, enableLassoSelection, enableBoxSelection, theme, }: {
+    title: string | undefined;
+    xAxis: AxisConfig;
+    yAxis: AxisConfig;
+    width: number;
+    height: number;
+    xRange: [number, number] | undefined;
+    yRange: [number, number] | undefined;
+    enableLassoSelection: boolean;
+    enableBoxSelection: boolean;
+    theme: PlotlyThemeColors;
+}) => Partial<Plotly.Layout>;

package/dist/components/charts/ScatterPlotInteractive/utils.js

@@ -0,0 +1,261 @@
+import { DEFAULT_MAX_POINTS as E, COLORS as d, DEFAULT_CATEGORY_COLORS as T, DEFAULT_MARKER_SIZE as y, DEFAULT_SIZE_RANGE as v, PLOT_CONSTANTS as f } from "./constants.js";
+function R(t, e) {
+  let r = Number.POSITIVE_INFINITY, n = Number.NEGATIVE_INFINITY;
+  for (const o of t) {
+    const l = o.metadata?.[e];
+    typeof l == "number" && Number.isFinite(l) && (r = Math.min(r, l), n = Math.max(n, l));
+  }
+  return !Number.isFinite(r) || !Number.isFinite(n) ? { min: 0, max: 1 } : r === n ? { min: r - 1, max: n + 1 } : { min: r, max: n };
+}
+function _(t, e) {
+  const r = t.map((n) => n.metadata?.[e]).filter((n) => typeof n == "string");
+  return [...new Set(r)].sort();
+}
+function X(t, e) {
+  if (!e || e.type === "static") {
+    const r = e?.value || d.primary;
+    return new Array(t.length).fill(r);
+  }
+  if (e.type === "categorical" && e.field) {
+    const r = _(t, e.field), n = e.categoryColors || {}, o = {};
+    return r.forEach((l, i) => {
+      o[l] = n[l] || T[i % T.length];
+    }), t.map((l) => {
+      const i = l.metadata?.[e.field];
+      return o[String(i)] || T[0];
+    });
+  }
+  return new Array(t.length).fill(d.primary);
+}
+function P(t, e) {
+  if (!e || e.type === "static") {
+    const r = e?.value || "circle";
+    return new Array(t.length).fill(r);
+  }
+  if (e.type === "categorical" && e.field) {
+    const r = _(t, e.field), n = e.categoryShapes || {}, o = ["circle", "square", "diamond", "cross", "x", "triangle-up", "triangle-down", "star"], l = {};
+    return r.forEach((i, a) => {
+      l[i] = n[i] || o[a % o.length];
+    }), t.map((i) => {
+      const a = i.metadata?.[e.field];
+      return l[String(a)] || "circle";
+    });
+  }
+  return new Array(t.length).fill("circle");
+}
+function G(t, e) {
+  if (!e || e.type === "static") {
+    const r = e?.value || y;
+    return new Array(t.length).fill(r);
+  }
+  if (e.type === "categorical" && e.field) {
+    const r = _(t, e.field), n = e.categorySizes || {}, o = {};
+    return r.forEach((l, i) => {
+      o[l] = n[l] || y + i * 2;
+    }), t.map((l) => {
+      const i = l.metadata?.[e.field];
+      return o[String(i)] || y;
+    });
+  }
+  if (e.type === "continuous" && e.field) {
+    const r = e.min !== void 0 && e.max !== void 0 ? { min: e.min, max: e.max } : R(t, e.field), n = e.sizeRange || v, [o, l] = n;
+    return t.map((i) => {
+      const a = i.metadata?.[e.field];
+      if (typeof a == "number" && Number.isFinite(a)) {
+        const s = (a - r.min) / (r.max - r.min);
+        return o + s * (l - o);
+      }
+      return y;
+    });
+  }
+  return new Array(t.length).fill(y);
+}
+function D(t, e) {
+  if (!e.enabled || t.length <= (e.maxPoints || E))
+    return t;
+  const r = e.maxPoints || E;
+  return (e.strategy || "lttb") === "lttb" ? Y(t, r) : t;
+}
+function h(t, e, r, n) {
+  const o = r - e;
+  if (o > 0) {
+    let i = 0, a = 0;
+    for (let s = e; s < r; s++)
+      i += t[s].x, a += t[s].y;
+    return { x: i / o, y: a / o };
+  }
+  const l = Math.max(0, Math.min(e, n - 1));
+  return { x: t[l].x, y: t[l].y };
+}
+function Y(t, e) {
+  const r = t.length;
+  if (e <= 0 || r === 0) return [];
+  if (e >= r) return t;
+  if (e === 1) return [t[0]];
+  if (e === 2) return [t[0], t[r - 1]];
+  const n = (r - 2) / (e - 2), { floor: o, abs: l, min: i } = Math, a = [t[0]];
+  let s = 0;
+  for (let c = 0; c < e - 2; c++) {
+    const u = i(o((c + 1) * n) + 1, r - 1), O = i(o((c + 2) * n) + 1, r), { x: b, y: L } = h(t, u, O, r), I = i(o(c * n) + 1, r - 1), C = i(o((c + 1) * n) + 1, r - 1), x = t[s].x, S = t[s].y;
+    let g = -1, A = t[I], N = I;
+    for (let m = I; m < C; m++) {
+      const F = l((x - b) * (t[m].y - S) - (x - t[m].x) * (L - S)) * 0.5;
+      F > g && (g = F, A = t[m], N = m);
+    }
+    a.push(A), s = N;
+  }
+  return a.push(t[r - 1]), a;
+}
+function Z(t, e) {
+  const r = [];
+  if (r.push(`X: ${t.x.toFixed(2)}`), r.push(`Y: ${t.y.toFixed(2)}`), t.label && r.push(`Label: ${t.label}`), e && t.metadata) {
+    for (const n of e)
+      if (n in t.metadata) {
+        const o = t.metadata[n];
+        r.push(`${n}: ${o}`);
+      }
+  } else if (t.metadata && !e)
+    for (const [n, o] of Object.entries(t.metadata))
+      r.push(`${n}: ${o}`);
+  return r.join("<br>");
+}
+function K(t) {
+  const e = t.ctrlKey || t.metaKey;
+  return t.shiftKey && e ? "toggle" : t.shiftKey ? "add" : e ? "remove" : "replace";
+}
+function $(t, e, r = 0.1, n = "linear") {
+  const o = n === "log";
+  let l = 1 / 0, i = -1 / 0;
+  for (const s of t) {
+    const c = s[e];
+    if (!Number.isFinite(c) || o && c <= 0) continue;
+    const u = o ? Math.log10(c) : c;
+    u < l && (l = u), u > i && (i = u);
+  }
+  if (!Number.isFinite(l))
+    return [0, 1];
+  if (l === i)
+    return [l - 1, i + 1];
+  const a = i - l;
+  return [l - a * r, i + a * r];
+}
+function k(t, e, r) {
+  const n = new Set(t);
+  switch (r) {
+    case "replace":
+      return new Set(e);
+    case "add":
+      for (const o of e)
+        n.add(o);
+      return n;
+    case "remove":
+      for (const o of e)
+        n.delete(o);
+      return n;
+    case "toggle":
+      for (const o of e)
+        n.has(o) ? n.delete(o) : n.add(o);
+      return n;
+    default:
+      return n;
+  }
+}
+const U = ({
+  title: t,
+  xAxis: e,
+  yAxis: r,
+  width: n,
+  height: o,
+  xRange: l,
+  yRange: i,
+  enableLassoSelection: a,
+  enableBoxSelection: s,
+  theme: c
+}) => ({
+  autosize: !1,
+  width: n,
+  height: o,
+  title: t ? {
+    text: t,
+    font: {
+      family: f.FONT_FAMILY,
+      size: f.TITLE_FONT_SIZE,
+      color: c.textColor
+    },
+    x: 0.5,
+    xanchor: "center"
+  } : void 0,
+  margin: {
+    l: f.MARGIN_LEFT,
+    r: f.MARGIN_RIGHT,
+    t: t ? f.MARGIN_TOP : f.MARGIN_TOP - f.TITLE_FONT_SIZE,
+    b: f.MARGIN_BOTTOM
+  },
+  xaxis: {
+    title: {
+      text: e.title || "",
+      font: {
+        family: f.FONT_FAMILY,
+        size: f.AXIS_TITLE_FONT_SIZE,
+        color: c.textSecondary
+      }
+    },
+    type: e.scale === "log" ? "log" : "linear",
+    range: l,
+    autorange: !l,
+    gridcolor: c.gridColor,
+    linecolor: c.lineColor,
+    linewidth: f.AXIS_LINE_WIDTH,
+    tickfont: {
+      family: f.FONT_FAMILY,
+      size: f.AXIS_TICK_FONT_SIZE,
+      color: c.textColor
+    },
+    zeroline: !1
+  },
+  yaxis: {
+    title: {
+      text: r.title || "",
+      font: {
+        family: f.FONT_FAMILY,
+        size: f.AXIS_TITLE_FONT_SIZE,
+        color: c.textSecondary
+      }
+    },
+    type: r.scale === "log" ? "log" : "linear",
+    range: i,
+    autorange: !i,
+    gridcolor: c.gridColor,
+    linecolor: c.lineColor,
+    linewidth: f.AXIS_LINE_WIDTH,
+    tickfont: {
+      family: f.FONT_FAMILY,
+      size: f.AXIS_TICK_FONT_SIZE,
+      color: c.textColor
+    },
+    zeroline: !1
+  },
+  paper_bgcolor: c.paperBg,
+  plot_bgcolor: c.plotBg,
+  font: {
+    family: f.FONT_FAMILY,
+    color: c.textColor
+  },
+  hovermode: "closest",
+  dragmode: a ? "lasso" : s ? "select" : !1
+});
+export {
+  k as applySelection,
+  $ as calculateAxisRange,
+  R as calculateRange,
+  D as downsampleData,
+  Z as generateTooltipContent,
+  U as getPlotlyLayoutConfig,
+  K as getSelectionMode,
+  _ as getUniqueCategories,
+  Y as lttbDownsample,
+  X as mapColors,
+  P as mapShapes,
+  G as mapSizes
+};
+//# sourceMappingURL=utils.js.map

package/dist/components/charts/ScatterPlotInteractive/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../../src/components/charts/ScatterPlotInteractive/utils.ts"],"sourcesContent":["import {\n  COLORS,\n  DEFAULT_CATEGORY_COLORS,\n  DEFAULT_MAX_POINTS,\n  DEFAULT_MARKER_SIZE,\n  DEFAULT_SIZE_RANGE,\n  PLOT_CONSTANTS,\n} from \"./constants\";\n\nimport type {\n  AxisConfig,\n  ColorMapping,\n  DownsamplingConfig,\n  ScatterPoint,\n  SelectionMode,\n  ShapeMapping,\n  SizeMapping,\n} from \"./types\";\nimport type { PlotlyThemeColors } from \"@/hooks/use-plotly-theme\";\n\n/**\n * Calculate min and max values for a numeric field in the data\n */\nexport function calculateRange(data: ScatterPoint[], field: string): { min: number; max: number } {\n  let min = Number.POSITIVE_INFINITY;\n  let max = Number.NEGATIVE_INFINITY;\n\n  for (const point of data) {\n    const value = point.metadata?.[field];\n    if (typeof value === \"number\" && Number.isFinite(value)) {\n      min = Math.min(min, value);\n      max = Math.max(max, value);\n    }\n  }\n\n  // Handle edge case where all values are invalid\n  if (!Number.isFinite(min) || !Number.isFinite(max)) {\n    return { min: 0, max: 1 };\n  }\n\n  // Handle edge case where min === max\n  if (min === max) {\n    return { min: min - 1, max: max + 1 };\n  }\n\n  return { min, max };\n}\n\n/**\n * Get unique categorical values from a field\n */\nexport function getUniqueCategories(data: ScatterPoint[], field: string): string[] {\n  const uniqueCategories = data\n    .map((point) => point.metadata?.[field])\n    .filter((value): value is string => typeof value === \"string\");\n\n  return [...new Set(uniqueCategories)].sort();\n}\n\n/**\n * Map colors based on color mapping configuration\n */\nexport function mapColors(data: ScatterPoint[], colorMapping?: ColorMapping): string[] {\n  if (!colorMapping || colorMapping.type === \"static\") {\n    const color = colorMapping?.value || COLORS.primary;\n    return new Array(data.length).fill(color);\n  }\n\n  if (colorMapping.type === \"categorical\" && colorMapping.field) {\n    const categories = getUniqueCategories(data, colorMapping.field);\n    const colorMap = colorMapping.categoryColors || {};\n\n    // Assign default colors to categories without explicit colors\n    const categoryColorMap: Record<string, string> = {};\n    categories.forEach((category, index) => {\n      categoryColorMap[category] =\n        colorMap[category] || DEFAULT_CATEGORY_COLORS[index % DEFAULT_CATEGORY_COLORS.length];\n    });\n\n    return data.map((point) => {\n      const value = point.metadata?.[colorMapping.field!];\n      return categoryColorMap[String(value)] || DEFAULT_CATEGORY_COLORS[0];\n    });\n  }\n\n  return new Array(data.length).fill(COLORS.primary);\n}\n\n/**\n * Map shapes based on shape mapping configuration\n */\nexport function mapShapes(data: ScatterPoint[], shapeMapping?: ShapeMapping): string[] {\n  if (!shapeMapping || shapeMapping.type === \"static\") {\n    const shape = shapeMapping?.value || \"circle\";\n    return new Array(data.length).fill(shape);\n  }\n\n  if (shapeMapping.type === \"categorical\" && shapeMapping.field) {\n    const categories = getUniqueCategories(data, shapeMapping.field);\n    const shapeMap = shapeMapping.categoryShapes || {};\n    const defaultShapes = [\"circle\", \"square\", \"diamond\", \"cross\", \"x\", \"triangle-up\", \"triangle-down\", \"star\"];\n\n    // Assign default shapes to categories without explicit shapes\n    const categoryShapeMap: Record<string, string> = {};\n    categories.forEach((category, index) => {\n      categoryShapeMap[category] = shapeMap[category] || defaultShapes[index % defaultShapes.length];\n    });\n\n    return data.map((point) => {\n      const value = point.metadata?.[shapeMapping.field!];\n      return categoryShapeMap[String(value)] || \"circle\";\n    });\n  }\n\n  return new Array(data.length).fill(\"circle\");\n}\n\n/**\n * Map sizes based on size mapping configuration\n */\nexport function mapSizes(data: ScatterPoint[], sizeMapping?: SizeMapping): number[] {\n  if (!sizeMapping || sizeMapping.type === \"static\") {\n    const size = sizeMapping?.value || DEFAULT_MARKER_SIZE;\n    return new Array(data.length).fill(size);\n  }\n\n  if (sizeMapping.type === \"categorical\" && sizeMapping.field) {\n    const categories = getUniqueCategories(data, sizeMapping.field);\n    const sizeMap = sizeMapping.categorySizes || {};\n\n    // Assign default sizes to categories without explicit sizes\n    const categorySizeMap: Record<string, number> = {};\n    categories.forEach((category, index) => {\n      categorySizeMap[category] = sizeMap[category] || DEFAULT_MARKER_SIZE + index * 2;\n    });\n\n    return data.map((point) => {\n      const value = point.metadata?.[sizeMapping.field!];\n      return categorySizeMap[String(value)] || DEFAULT_MARKER_SIZE;\n    });\n  }\n\n  if (sizeMapping.type === \"continuous\" && sizeMapping.field) {\n    const range =\n      sizeMapping.min !== undefined && sizeMapping.max !== undefined\n        ? { min: sizeMapping.min, max: sizeMapping.max }\n        : calculateRange(data, sizeMapping.field);\n\n    const sizeRange = sizeMapping.sizeRange || DEFAULT_SIZE_RANGE;\n    const [minSize, maxSize] = sizeRange;\n\n    return data.map((point) => {\n      const value = point.metadata?.[sizeMapping.field!];\n      if (typeof value === \"number\" && Number.isFinite(value)) {\n        // Normalize and map to size range\n        const normalized = (value - range.min) / (range.max - range.min);\n        return minSize + normalized * (maxSize - minSize);\n      }\n      return DEFAULT_MARKER_SIZE;\n    });\n  }\n\n  return new Array(data.length).fill(DEFAULT_MARKER_SIZE);\n}\n\n/**\n * Downsample data using specified strategy\n */\nexport function downsampleData(data: ScatterPoint[], config: DownsamplingConfig): ScatterPoint[] {\n  if (!config.enabled || data.length <= (config.maxPoints || DEFAULT_MAX_POINTS)) {\n    return data;\n  }\n\n  const maxPoints = config.maxPoints || DEFAULT_MAX_POINTS;\n  const strategy = config.strategy || \"lttb\";\n\n  if (strategy === \"lttb\") {\n    // Largest Triangle Three Buckets algorithm\n    return lttbDownsample(data, maxPoints);\n  }\n\n  return data;\n}\n\n/**\n * Compute the (x, y) centroid of data[start..end).\n * Falls back to the point at clamp(start, 0, dataLength-1) when the range is\n * empty (only reachable under extreme floating-point drift) to prevent NaN.\n */\nfunction bucketCentroid(\n  data: ScatterPoint[],\n  start: number,\n  end: number,\n  dataLength: number,\n): { x: number; y: number } {\n  const length = end - start;\n  if (length > 0) {\n    let sumX = 0;\n    let sumY = 0;\n    for (let j = start; j < end; j++) {\n      sumX += data[j].x;\n      sumY += data[j].y;\n    }\n    return { x: sumX / length, y: sumY / length };\n  }\n  const fallbackIdx = Math.max(0, Math.min(start, dataLength - 1));\n  return { x: data[fallbackIdx].x, y: data[fallbackIdx].y };\n}\n\n/**\n * Largest Triangle Three Buckets (LTTB) downsampling algorithm.\n * Preserves the visual shape of the data by maximizing the triangle area\n * formed by adjacent bucket centroids and each candidate point.\n * Exported for unit testing\n */\nexport function lttbDownsample(data: ScatterPoint[], threshold: number): ScatterPoint[] {\n  const dataLength = data.length;\n\n  // --- Edge cases ---\n  if (threshold <= 0 || dataLength === 0) return [];\n  // No downsampling needed; return the original reference unchanged.\n  if (threshold >= dataLength) return data;\n  if (threshold === 1) return [data[0]];\n  if (threshold === 2) return [data[0], data[dataLength - 1]];\n\n  // At this point: 3 <= threshold < dataLength, so dataLength >= 4.\n  // Spread (dataLength - 2) interior points across (threshold - 2) buckets,\n  // keeping the first and last points fixed outside the buckets.\n  // With threshold < dataLength, every > 1, so no bucket is ever empty.\n  const every = (dataLength - 2) / (threshold - 2);\n\n  const { floor, abs, min } = Math;\n  const sampled: ScatterPoint[] = [data[0]];\n\n  // Index of the previously selected point — left vertex A of the triangle.\n  let a = 0;\n\n  for (let i = 0; i < threshold - 2; i++) {\n    // Centroid of the *next* bucket — right vertex C of the triangle.\n    // Biases candidate selection toward points that preserve visual variance.\n    const avgRangeStart = min(floor((i + 1) * every) + 1, dataLength - 1);\n    const avgRangeEnd = min(floor((i + 2) * every) + 1, dataLength);\n    const { x: avgX, y: avgY } = bucketCentroid(data, avgRangeStart, avgRangeEnd, dataLength);\n\n    // Boundaries of the current bucket — middle vertex B candidates.\n    // Clamped to valid index range to guard against floating-point drift.\n    const rangeStart = min(floor(i * every) + 1, dataLength - 1);\n    const rangeEnd = min(floor((i + 1) * every) + 1, dataLength - 1);\n\n    const pointAX = data[a].x;\n    const pointAY = data[a].y;\n\n    // Safe fallback: first point in the bucket, used when the bucket is degenerate.\n    let maxArea = -1;\n    let maxAreaPoint: ScatterPoint = data[rangeStart];\n    let nextA = rangeStart;\n\n    for (let j = rangeStart; j < rangeEnd; j++) {\n      // Area of the triangle formed by A (prev selected), B (candidate), C (next centroid).\n      // The point maximising this area is the most visually significant in the bucket.\n      const area = abs((pointAX - avgX) * (data[j].y - pointAY) - (pointAX - data[j].x) * (avgY - pointAY)) * 0.5;\n      if (area > maxArea) {\n        maxArea = area;\n        maxAreaPoint = data[j];\n        nextA = j;\n      }\n    }\n\n    sampled.push(maxAreaPoint);\n    a = nextA;\n  }\n\n  sampled.push(data[dataLength - 1]); // Always include the last point.\n\n  return sampled;\n}\n\n/**\n * Generate default tooltip content\n */\nexport function generateTooltipContent(point: ScatterPoint, fields?: string[]): string {\n  const lines: string[] = [];\n\n  // Always include x, y\n  lines.push(`X: ${point.x.toFixed(2)}`);\n  lines.push(`Y: ${point.y.toFixed(2)}`);\n\n  // Add label if present\n  if (point.label) {\n    lines.push(`Label: ${point.label}`);\n  }\n\n  // Add requested fields from metadata\n  if (fields && point.metadata) {\n    for (const field of fields) {\n      if (field in point.metadata) {\n        const value = point.metadata[field];\n        lines.push(`${field}: ${value}`);\n      }\n    }\n  } else if (point.metadata && !fields) {\n    // If no fields specified, show all metadata\n    for (const [key, value] of Object.entries(point.metadata)) {\n      lines.push(`${key}: ${value}`);\n    }\n  }\n\n  return lines.join(\"<br>\");\n}\n\n/**\n * Determine selection mode from keyboard event\n */\nexport function getSelectionMode(event: { shiftKey: boolean; ctrlKey: boolean; metaKey: boolean }): SelectionMode {\n  const ctrlOrCmd = event.ctrlKey || event.metaKey;\n\n  if (event.shiftKey && ctrlOrCmd) {\n    return \"toggle\";\n  }\n  if (event.shiftKey) {\n    return \"add\";\n  }\n  if (ctrlOrCmd) {\n    return \"remove\";\n  }\n  return \"replace\";\n}\n\n/**\n * Calculate axis range with padding.\n *\n * When `scale` is `\"log\"`, the returned range is in log10 units (what Plotly\n * expects for `type: \"log\"` axes), and padding is applied in log-space so that\n * the visual margin is proportional on the logarithmic axis.\n */\nexport function calculateAxisRange(\n  data: ScatterPoint[],\n  axis: \"x\" | \"y\",\n  padding = 0.1,\n  scale: \"linear\" | \"log\" = \"linear\",\n): [number, number] {\n  const isLog = scale === \"log\";\n  let min = Infinity;\n  let max = -Infinity;\n\n  for (const point of data) {\n    const v = point[axis];\n    if (!Number.isFinite(v)) continue;\n    // log10 is undefined for non-positive values — skip them silently\n    if (isLog && v <= 0) continue;\n    // Plotly log axes expect range bounds in log10 units\n    const mapped = isLog ? Math.log10(v) : v;\n    if (mapped < min) min = mapped;\n    if (mapped > max) max = mapped;\n  }\n\n  if (!Number.isFinite(min)) {\n    return [0, 1];\n  }\n\n  if (min === max) {\n    return [min - 1, max + 1];\n  }\n\n  const range = max - min;\n  return [min - range * padding, max + range * padding];\n}\n\n/**\n * Apply selection to a set of point IDs\n */\nexport function applySelection(\n  currentSelection: Set<string | number>,\n  newIds: Set<string | number>,\n  mode: SelectionMode,\n): Set<string | number> {\n  const result = new Set(currentSelection);\n\n  switch (mode) {\n    case \"replace\":\n      return new Set(newIds);\n\n    case \"add\":\n      for (const id of newIds) {\n        result.add(id);\n      }\n      return result;\n\n    case \"remove\":\n      for (const id of newIds) {\n        result.delete(id);\n      }\n      return result;\n\n    case \"toggle\":\n      for (const id of newIds) {\n        if (result.has(id)) {\n          result.delete(id);\n        } else {\n          result.add(id);\n        }\n      }\n      return result;\n\n    default:\n      return result;\n  }\n}\n\nexport const getPlotlyLayoutConfig = ({\n  title,\n  xAxis,\n  yAxis,\n  width,\n  height,\n  xRange,\n  yRange,\n  enableLassoSelection,\n  enableBoxSelection,\n  theme,\n}: {\n  title: string | undefined;\n  xAxis: AxisConfig;\n  yAxis: AxisConfig;\n  width: number;\n  height: number;\n  xRange: [number, number] | undefined;\n  yRange: [number, number] | undefined;\n  enableLassoSelection: boolean;\n  enableBoxSelection: boolean;\n  theme: PlotlyThemeColors;\n}): Partial<Plotly.Layout> => ({\n  autosize: false,\n  width,\n  height,\n  title: title\n    ? {\n        text: title,\n        font: {\n          family: PLOT_CONSTANTS.FONT_FAMILY,\n          size: PLOT_CONSTANTS.TITLE_FONT_SIZE,\n          color: theme.textColor,\n        },\n        x: 0.5,\n        xanchor: \"center\",\n      }\n    : undefined,\n  margin: {\n    l: PLOT_CONSTANTS.MARGIN_LEFT,\n    r: PLOT_CONSTANTS.MARGIN_RIGHT,\n    t: title ? PLOT_CONSTANTS.MARGIN_TOP : PLOT_CONSTANTS.MARGIN_TOP - PLOT_CONSTANTS.TITLE_FONT_SIZE,\n    b: PLOT_CONSTANTS.MARGIN_BOTTOM,\n  },\n  xaxis: {\n    title: {\n      text: xAxis.title || \"\",\n      font: {\n        family: PLOT_CONSTANTS.FONT_FAMILY,\n        size: PLOT_CONSTANTS.AXIS_TITLE_FONT_SIZE,\n        color: theme.textSecondary,\n      },\n    },\n    type: xAxis.scale === \"log\" ? \"log\" : \"linear\",\n    range: xRange,\n    autorange: !xRange,\n    gridcolor: theme.gridColor,\n    linecolor: theme.lineColor,\n    linewidth: PLOT_CONSTANTS.AXIS_LINE_WIDTH,\n    tickfont: {\n      family: PLOT_CONSTANTS.FONT_FAMILY,\n      size: PLOT_CONSTANTS.AXIS_TICK_FONT_SIZE,\n      color: theme.textColor,\n    },\n    zeroline: false,\n  },\n  yaxis: {\n    title: {\n      text: yAxis.title || \"\",\n      font: {\n        family: PLOT_CONSTANTS.FONT_FAMILY,\n        size: PLOT_CONSTANTS.AXIS_TITLE_FONT_SIZE,\n        color: theme.textSecondary,\n      },\n    },\n    type: yAxis.scale === \"log\" ? \"log\" : \"linear\",\n    range: yRange,\n    autorange: !yRange,\n    gridcolor: theme.gridColor,\n    linecolor: theme.lineColor,\n    linewidth: PLOT_CONSTANTS.AXIS_LINE_WIDTH,\n    tickfont: {\n      family: PLOT_CONSTANTS.FONT_FAMILY,\n      size: PLOT_CONSTANTS.AXIS_TICK_FONT_SIZE,\n      color: theme.textColor,\n    },\n    zeroline: false,\n  },\n  paper_bgcolor: theme.paperBg,\n  plot_bgcolor: theme.plotBg,\n  font: {\n    family: PLOT_CONSTANTS.FONT_FAMILY,\n    color: theme.textColor,\n  },\n  hovermode: \"closest\",\n  dragmode: enableLassoSelection ? \"lasso\" : enableBoxSelection ? \"select\" : false,\n});\n"],"names":["calculateRange","data","field","min","max","point","value","getUniqueCategories","uniqueCategories","mapColors","colorMapping","color","COLORS","categories","colorMap","categoryColorMap","category","index","DEFAULT_CATEGORY_COLORS","mapShapes","shapeMapping","shape","shapeMap","defaultShapes","categoryShapeMap","mapSizes","sizeMapping","size","DEFAULT_MARKER_SIZE","sizeMap","categorySizeMap","range","sizeRange","DEFAULT_SIZE_RANGE","minSize","maxSize","normalized","downsampleData","config","DEFAULT_MAX_POINTS","maxPoints","lttbDownsample","bucketCentroid","start","end","dataLength","length","sumX","sumY","j","fallbackIdx","threshold","every","floor","abs","sampled","a","i","avgRangeStart","avgRangeEnd","avgX","avgY","rangeStart","rangeEnd","pointAX","pointAY","maxArea","maxAreaPoint","nextA","area","generateTooltipContent","fields","lines","key","getSelectionMode","event","ctrlOrCmd","calculateAxisRange","axis","padding","scale","isLog","v","mapped","applySelection","currentSelection","newIds","mode","result","id","getPlotlyLayoutConfig","title","xAxis","yAxis","width","height","xRange","yRange","enableLassoSelection","enableBoxSelection","theme","PLOT_CONSTANTS"],"mappings":"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"}

package/dist/components/charts/StackedChromatogram/StackedChromatogram.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react/jsx-runtime"),c=require("react"),g=require("../Chromatogram/Chromatogram.cjs"),S=require("./transforms.cjs");function f({series:r,stackingMode:o="overlay",stackOffset:t=0,stackingOrder:e="first-on-bottom",annotations:n,...a}){const{series:s,annotations:m,yRange:i}=c.useMemo(()=>S.applyStackingTransform(r,n,o,t,e),[r,n,o,t,e]);return u.jsx(g.Chromatogram,{...a,series:s,annotations:m,yRange:i})}exports.StackedChromatogram=f;
+//# sourceMappingURL=StackedChromatogram.cjs.map

package/dist/components/charts/StackedChromatogram/StackedChromatogram.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StackedChromatogram.cjs","sources":["../../../../src/components/charts/StackedChromatogram/StackedChromatogram.tsx"],"sourcesContent":["import { useMemo } from \"react\";\n\nimport { Chromatogram } from \"../Chromatogram\";\n\nimport { applyStackingTransform } from \"./transforms\";\n\nimport type { StackedChromatogramProps } from \"./types\";\n\nexport function StackedChromatogram({\n  series,\n  stackingMode = \"overlay\",\n  stackOffset = 0,\n  stackingOrder = \"first-on-bottom\",\n  annotations,\n  ...restProps\n}: StackedChromatogramProps) {\n  const {\n    series: transformedSeries,\n    annotations: transformedAnnotations,\n    yRange,\n  } = useMemo(\n    () =>\n      applyStackingTransform(\n        series,\n        annotations,\n        stackingMode,\n        stackOffset,\n        stackingOrder\n      ),\n    [series, annotations, stackingMode, stackOffset, stackingOrder]\n  );\n\n  return (\n    <Chromatogram\n      {...restProps}\n      series={transformedSeries}\n      annotations={transformedAnnotations}\n      yRange={yRange}\n    />\n  );\n}\n\nexport default StackedChromatogram;\n"],"names":["StackedChromatogram","series","stackingMode","stackOffset","stackingOrder","annotations","restProps","transformedSeries","transformedAnnotations","yRange","useMemo","applyStackingTransform","jsx","Chromatogram"],"mappings":"oNAQO,SAASA,EAAoB,CAClC,OAAAC,EACA,aAAAC,EAAe,UACf,YAAAC,EAAc,EACd,cAAAC,EAAgB,kBAChB,YAAAC,EACA,GAAGC,CACL,EAA6B,CAC3B,KAAM,CACJ,OAAQC,EACR,YAAaC,EACb,OAAAC,CAAA,EACEC,EAAAA,QACF,IACEC,EAAAA,uBACEV,EACAI,EACAH,EACAC,EACAC,CAAA,EAEJ,CAACH,EAAQI,EAAaH,EAAcC,EAAaC,CAAa,CAAA,EAGhE,OACEQ,EAAAA,IAACC,EAAAA,aAAA,CACE,GAAGP,EACJ,OAAQC,EACR,YAAaC,EACb,OAAAC,CAAA,CAAA,CAGN"}

package/dist/components/charts/StackedChromatogram/StackedChromatogram.d.ts

@@ -0,0 +1,3 @@
+import { StackedChromatogramProps } from './types';
+export declare function StackedChromatogram({ series, stackingMode, stackOffset, stackingOrder, annotations, ...restProps }: StackedChromatogramProps): import("react/jsx-runtime").JSX.Element;
+export default StackedChromatogram;

package/dist/components/charts/StackedChromatogram/StackedChromatogram.js

@@ -0,0 +1,40 @@
+import { jsx as f } from "react/jsx-runtime";
+import { useMemo as p } from "react";
+import { Chromatogram as u } from "../Chromatogram/Chromatogram.js";
+import { applyStackingTransform as y } from "./transforms.js";
+function x({
+  series: o,
+  stackingMode: r = "overlay",
+  stackOffset: m = 0,
+  stackingOrder: t = "first-on-bottom",
+  annotations: n,
+  ...a
+}) {
+  const {
+    series: e,
+    annotations: i,
+    yRange: s
+  } = p(
+    () => y(
+      o,
+      n,
+      r,
+      m,
+      t
+    ),
+    [o, n, r, m, t]
+  );
+  return /* @__PURE__ */ f(
+    u,
+    {
+      ...a,
+      series: e,
+      annotations: i,
+      yRange: s
+    }
+  );
+}
+export {
+  x as StackedChromatogram
+};
+//# sourceMappingURL=StackedChromatogram.js.map

package/dist/components/charts/StackedChromatogram/StackedChromatogram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StackedChromatogram.js","sources":["../../../../src/components/charts/StackedChromatogram/StackedChromatogram.tsx"],"sourcesContent":["import { useMemo } from \"react\";\n\nimport { Chromatogram } from \"../Chromatogram\";\n\nimport { applyStackingTransform } from \"./transforms\";\n\nimport type { StackedChromatogramProps } from \"./types\";\n\nexport function StackedChromatogram({\n  series,\n  stackingMode = \"overlay\",\n  stackOffset = 0,\n  stackingOrder = \"first-on-bottom\",\n  annotations,\n  ...restProps\n}: StackedChromatogramProps) {\n  const {\n    series: transformedSeries,\n    annotations: transformedAnnotations,\n    yRange,\n  } = useMemo(\n    () =>\n      applyStackingTransform(\n        series,\n        annotations,\n        stackingMode,\n        stackOffset,\n        stackingOrder\n      ),\n    [series, annotations, stackingMode, stackOffset, stackingOrder]\n  );\n\n  return (\n    <Chromatogram\n      {...restProps}\n      series={transformedSeries}\n      annotations={transformedAnnotations}\n      yRange={yRange}\n    />\n  );\n}\n\nexport default StackedChromatogram;\n"],"names":["StackedChromatogram","series","stackingMode","stackOffset","stackingOrder","annotations","restProps","transformedSeries","transformedAnnotations","yRange","useMemo","applyStackingTransform","jsx","Chromatogram"],"mappings":";;;;AAQO,SAASA,EAAoB;AAAA,EAClC,QAAAC;AAAA,EACA,cAAAC,IAAe;AAAA,EACf,aAAAC,IAAc;AAAA,EACd,eAAAC,IAAgB;AAAA,EAChB,aAAAC;AAAA,EACA,GAAGC;AACL,GAA6B;AAC3B,QAAM;AAAA,IACJ,QAAQC;AAAA,IACR,aAAaC;AAAA,IACb,QAAAC;AAAA,EAAA,IACEC;AAAA,IACF,MACEC;AAAA,MACEV;AAAA,MACAI;AAAA,MACAH;AAAA,MACAC;AAAA,MACAC;AAAA,IAAA;AAAA,IAEJ,CAACH,GAAQI,GAAaH,GAAcC,GAAaC,CAAa;AAAA,EAAA;AAGhE,SACE,gBAAAQ;AAAA,IAACC;AAAA,IAAA;AAAA,MACE,GAAGP;AAAA,MACJ,QAAQC;AAAA,MACR,aAAaC;AAAA,MACb,QAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/charts/StackedChromatogram/index.d.ts

@@ -0,0 +1,3 @@
+export { StackedChromatogram } from './StackedChromatogram';
+export type { StackedChromatogramProps, StackingMode } from './types';
+export { applyStackingTransform } from './transforms';

package/dist/components/charts/StackedChromatogram/transforms.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function S(a,o,h,e,i="first-on-bottom"){const y=a.flatMap(t=>t.y),g=Math.min(...y,0),p=Math.max(...y),Y=[g,p];if(h==="overlay")return{series:a,annotations:o?o.flat():[],yRange:Y};const d=a.length,f=t=>i==="first-on-top"?(d-1-t)*e:t*e,r=a.map((t,s)=>({...t,y:t.y.map(c=>c+f(s))})),n=[];o&&o.forEach((t,s)=>{const c=f(s);t.forEach(M=>{n.push({...M,y:M.y+c})})});const l=r.flatMap(t=>t.y),m=n.map(t=>t.y),u=Math.min(...l,...m,0),x=Math.max(...l,...m);return{series:r,annotations:n,yRange:[u,x]}}exports.applyStackingTransform=S;
+//# sourceMappingURL=transforms.cjs.map

package/dist/components/charts/StackedChromatogram/transforms.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.cjs","sources":["../../../../src/components/charts/StackedChromatogram/transforms.ts"],"sourcesContent":["import type { ChromatogramSeries, PeakAnnotation } from \"../Chromatogram\";\nimport type { StackingMode } from \"./types\";\n\ninterface TransformResult {\n  series: ChromatogramSeries[];\n  annotations: PeakAnnotation[];\n  yRange: [number, number];\n}\n\nexport function applyStackingTransform(\n  inputSeries: ChromatogramSeries[],\n  inputAnnotations: PeakAnnotation[][] | undefined,\n  mode: StackingMode,\n  stackOffset: number,\n  stackingOrder: \"first-on-bottom\" | \"first-on-top\" = \"first-on-bottom\"\n): TransformResult {\n  const yValues = inputSeries.flatMap((s) => s.y);\n  const yMin = Math.min(...yValues, 0);\n  const yMax = Math.max(...yValues);\n  const consistentYRange: [number, number] = [yMin, yMax];\n\n  if (mode === \"overlay\") {\n    return {\n      series: inputSeries,\n      annotations: inputAnnotations ? inputAnnotations.flat() : [],\n      yRange: consistentYRange,\n    };\n  }\n\n  // 'stack' mode: shift each series up by its index × stackOffset\n  const N = inputSeries.length;\n  const yShiftForIndex = (index: number): number =>\n    stackingOrder === \"first-on-top\"\n      ? (N - 1 - index) * stackOffset\n      : index * stackOffset;\n\n  const offsetSeries: ChromatogramSeries[] = inputSeries.map(\n    (series, index) => ({\n      ...series,\n      y: series.y.map((yVal) => yVal + yShiftForIndex(index)),\n    })\n  );\n\n  const offsetAnnotations: PeakAnnotation[] = [];\n  if (inputAnnotations) {\n    inputAnnotations.forEach((seriesAnnotations, seriesIndex) => {\n      const yShift = yShiftForIndex(seriesIndex);\n      seriesAnnotations.forEach((ann) => {\n        offsetAnnotations.push({ ...ann, y: ann.y + yShift });\n      });\n    });\n  }\n\n  const allYValues = offsetSeries.flatMap((s) => s.y);\n  const annotationYValues = offsetAnnotations.map((a) => a.y);\n  const stackedYMin = Math.min(...allYValues, ...annotationYValues, 0);\n  const stackedYMax = Math.max(...allYValues, ...annotationYValues);\n\n  return {\n    series: offsetSeries,\n    annotations: offsetAnnotations,\n    yRange: [stackedYMin, stackedYMax],\n  };\n}\n"],"names":["applyStackingTransform","inputSeries","inputAnnotations","mode","stackOffset","stackingOrder","yValues","s","yMin","yMax","consistentYRange","N","yShiftForIndex","index","offsetSeries","series","yVal","offsetAnnotations","seriesAnnotations","seriesIndex","yShift","ann","allYValues","annotationYValues","a","stackedYMin","stackedYMax"],"mappings":"gFASO,SAASA,EACdC,EACAC,EACAC,EACAC,EACAC,EAAoD,kBACnC,CACjB,MAAMC,EAAUL,EAAY,QAASM,GAAMA,EAAE,CAAC,EACxCC,EAAO,KAAK,IAAI,GAAGF,EAAS,CAAC,EAC7BG,EAAO,KAAK,IAAI,GAAGH,CAAO,EAC1BI,EAAqC,CAACF,EAAMC,CAAI,EAEtD,GAAIN,IAAS,UACX,MAAO,CACL,OAAQF,EACR,YAAaC,EAAmBA,EAAiB,KAAA,EAAS,CAAA,EAC1D,OAAQQ,CAAA,EAKZ,MAAMC,EAAIV,EAAY,OAChBW,EAAkBC,GACtBR,IAAkB,gBACbM,EAAI,EAAIE,GAAST,EAClBS,EAAQT,EAERU,EAAqCb,EAAY,IACrD,CAACc,EAAQF,KAAW,CAClB,GAAGE,EACH,EAAGA,EAAO,EAAE,IAAKC,GAASA,EAAOJ,EAAeC,CAAK,CAAC,CAAA,EACxD,EAGII,EAAsC,CAAA,EACxCf,GACFA,EAAiB,QAAQ,CAACgB,EAAmBC,IAAgB,CAC3D,MAAMC,EAASR,EAAeO,CAAW,EACzCD,EAAkB,QAASG,GAAQ,CACjCJ,EAAkB,KAAK,CAAE,GAAGI,EAAK,EAAGA,EAAI,EAAID,EAAQ,CACtD,CAAC,CACH,CAAC,EAGH,MAAME,EAAaR,EAAa,QAASP,GAAMA,EAAE,CAAC,EAC5CgB,EAAoBN,EAAkB,IAAKO,GAAMA,EAAE,CAAC,EACpDC,EAAc,KAAK,IAAI,GAAGH,EAAY,GAAGC,EAAmB,CAAC,EAC7DG,EAAc,KAAK,IAAI,GAAGJ,EAAY,GAAGC,CAAiB,EAEhE,MAAO,CACL,OAAQT,EACR,YAAaG,EACb,OAAQ,CAACQ,EAAaC,CAAW,CAAA,CAErC"}

package/dist/components/charts/StackedChromatogram/transforms.d.ts

@@ -0,0 +1,9 @@
+import { ChromatogramSeries, PeakAnnotation } from '../Chromatogram';
+import { StackingMode } from './types';
+interface TransformResult {
+    series: ChromatogramSeries[];
+    annotations: PeakAnnotation[];
+    yRange: [number, number];
+}
+export declare function applyStackingTransform(inputSeries: ChromatogramSeries[], inputAnnotations: PeakAnnotation[][] | undefined, mode: StackingMode, stackOffset: number, stackingOrder?: "first-on-bottom" | "first-on-top"): TransformResult;
+export {};

package/dist/components/charts/StackedChromatogram/transforms.js

@@ -0,0 +1,31 @@
+function d(t, o, m, y, i = "first-on-bottom") {
+  const f = t.flatMap((a) => a.y), g = Math.min(...f, 0), x = Math.max(...f), Y = [g, x];
+  if (m === "overlay")
+    return {
+      series: t,
+      annotations: o ? o.flat() : [],
+      yRange: Y
+    };
+  const p = t.length, e = (a) => i === "first-on-top" ? (p - 1 - a) * y : a * y, r = t.map(
+    (a, s) => ({
+      ...a,
+      y: a.y.map((c) => c + e(s))
+    })
+  ), n = [];
+  o && o.forEach((a, s) => {
+    const c = e(s);
+    a.forEach((M) => {
+      n.push({ ...M, y: M.y + c });
+    });
+  });
+  const l = r.flatMap((a) => a.y), h = n.map((a) => a.y), R = Math.min(...l, ...h, 0), V = Math.max(...l, ...h);
+  return {
+    series: r,
+    annotations: n,
+    yRange: [R, V]
+  };
+}
+export {
+  d as applyStackingTransform
+};
+//# sourceMappingURL=transforms.js.map

package/dist/components/charts/StackedChromatogram/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.js","sources":["../../../../src/components/charts/StackedChromatogram/transforms.ts"],"sourcesContent":["import type { ChromatogramSeries, PeakAnnotation } from \"../Chromatogram\";\nimport type { StackingMode } from \"./types\";\n\ninterface TransformResult {\n  series: ChromatogramSeries[];\n  annotations: PeakAnnotation[];\n  yRange: [number, number];\n}\n\nexport function applyStackingTransform(\n  inputSeries: ChromatogramSeries[],\n  inputAnnotations: PeakAnnotation[][] | undefined,\n  mode: StackingMode,\n  stackOffset: number,\n  stackingOrder: \"first-on-bottom\" | \"first-on-top\" = \"first-on-bottom\"\n): TransformResult {\n  const yValues = inputSeries.flatMap((s) => s.y);\n  const yMin = Math.min(...yValues, 0);\n  const yMax = Math.max(...yValues);\n  const consistentYRange: [number, number] = [yMin, yMax];\n\n  if (mode === \"overlay\") {\n    return {\n      series: inputSeries,\n      annotations: inputAnnotations ? inputAnnotations.flat() : [],\n      yRange: consistentYRange,\n    };\n  }\n\n  // 'stack' mode: shift each series up by its index × stackOffset\n  const N = inputSeries.length;\n  const yShiftForIndex = (index: number): number =>\n    stackingOrder === \"first-on-top\"\n      ? (N - 1 - index) * stackOffset\n      : index * stackOffset;\n\n  const offsetSeries: ChromatogramSeries[] = inputSeries.map(\n    (series, index) => ({\n      ...series,\n      y: series.y.map((yVal) => yVal + yShiftForIndex(index)),\n    })\n  );\n\n  const offsetAnnotations: PeakAnnotation[] = [];\n  if (inputAnnotations) {\n    inputAnnotations.forEach((seriesAnnotations, seriesIndex) => {\n      const yShift = yShiftForIndex(seriesIndex);\n      seriesAnnotations.forEach((ann) => {\n        offsetAnnotations.push({ ...ann, y: ann.y + yShift });\n      });\n    });\n  }\n\n  const allYValues = offsetSeries.flatMap((s) => s.y);\n  const annotationYValues = offsetAnnotations.map((a) => a.y);\n  const stackedYMin = Math.min(...allYValues, ...annotationYValues, 0);\n  const stackedYMax = Math.max(...allYValues, ...annotationYValues);\n\n  return {\n    series: offsetSeries,\n    annotations: offsetAnnotations,\n    yRange: [stackedYMin, stackedYMax],\n  };\n}\n"],"names":["applyStackingTransform","inputSeries","inputAnnotations","mode","stackOffset","stackingOrder","yValues","s","yMin","yMax","consistentYRange","N","yShiftForIndex","index","offsetSeries","series","yVal","offsetAnnotations","seriesAnnotations","seriesIndex","yShift","ann","allYValues","annotationYValues","stackedYMin","stackedYMax"],"mappings":"AASO,SAASA,EACdC,GACAC,GACAC,GACAC,GACAC,IAAoD,mBACnC;AACjB,QAAMC,IAAUL,EAAY,QAAQ,CAACM,MAAMA,EAAE,CAAC,GACxCC,IAAO,KAAK,IAAI,GAAGF,GAAS,CAAC,GAC7BG,IAAO,KAAK,IAAI,GAAGH,CAAO,GAC1BI,IAAqC,CAACF,GAAMC,CAAI;AAEtD,MAAIN,MAAS;AACX,WAAO;AAAA,MACL,QAAQF;AAAA,MACR,aAAaC,IAAmBA,EAAiB,KAAA,IAAS,CAAA;AAAA,MAC1D,QAAQQ;AAAA,IAAA;AAKZ,QAAMC,IAAIV,EAAY,QAChBW,IAAiB,CAACC,MACtBR,MAAkB,kBACbM,IAAI,IAAIE,KAAST,IAClBS,IAAQT,GAERU,IAAqCb,EAAY;AAAA,IACrD,CAACc,GAAQF,OAAW;AAAA,MAClB,GAAGE;AAAA,MACH,GAAGA,EAAO,EAAE,IAAI,CAACC,MAASA,IAAOJ,EAAeC,CAAK,CAAC;AAAA,IAAA;AAAA,EACxD,GAGII,IAAsC,CAAA;AAC5C,EAAIf,KACFA,EAAiB,QAAQ,CAACgB,GAAmBC,MAAgB;AAC3D,UAAMC,IAASR,EAAeO,CAAW;AACzC,IAAAD,EAAkB,QAAQ,CAACG,MAAQ;AACjC,MAAAJ,EAAkB,KAAK,EAAE,GAAGI,GAAK,GAAGA,EAAI,IAAID,GAAQ;AAAA,IACtD,CAAC;AAAA,EACH,CAAC;AAGH,QAAME,IAAaR,EAAa,QAAQ,CAACP,MAAMA,EAAE,CAAC,GAC5CgB,IAAoBN,EAAkB,IAAI,CAAC,MAAM,EAAE,CAAC,GACpDO,IAAc,KAAK,IAAI,GAAGF,GAAY,GAAGC,GAAmB,CAAC,GAC7DE,IAAc,KAAK,IAAI,GAAGH,GAAY,GAAGC,CAAiB;AAEhE,SAAO;AAAA,IACL,QAAQT;AAAA,IACR,aAAaG;AAAA,IACb,QAAQ,CAACO,GAAaC,CAAW;AAAA,EAAA;AAErC;"}

package/dist/components/charts/StackedChromatogram/types.d.ts

@@ -0,0 +1,26 @@
+import { ChromatogramProps, ChromatogramSeries, PeakAnnotation } from '../Chromatogram';
+export type StackingMode = "overlay" | "stack";
+export interface StackedChromatogramProps extends Omit<ChromatogramProps, "series" | "annotations" | "yRange"> {
+    /** Array of data series to display */
+    series: ChromatogramSeries[];
+    /** Stacking mode: 'overlay' (default) or 'stack' */
+    stackingMode?: StackingMode;
+    /**
+     * Y-offset between stacked series in data units (e.g., AU).
+     * Only applies in 'stack' mode; ignored in 'overlay'.
+     */
+    stackOffset?: number;
+    /**
+     * Peak annotations per series, parallel to the series array.
+     * annotations[i] corresponds to series[i].
+     * In stack mode, y values are shifted by the series offset.
+     */
+    annotations?: PeakAnnotation[][];
+    /**
+     * Controls which end of the stack series[0] lands on (stack mode only).
+     * - "first-on-bottom" (default) — series[0] sits at the base; series[N-1] is highest.
+     * - "first-on-top" — series[0] is shifted to the top; series[N-1] is at the base.
+     *   Annotations follow the chosen direction.
+     */
+    stackingOrder?: "first-on-bottom" | "first-on-top";
+}

package/dist/components/charts/plotly-loader.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function d(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const l in e)if(l!=="default"){const n=Object.getOwnPropertyDescriptor(e,l);Object.defineProperty(t,l,n.get?n:{enumerable:!0,get:()=>e[l]})}}return t.default=e,Object.freeze(t)}const a="Failed to load 'plotly.js-dist'. It is an optional peer dependency of @tetrascience-npm/tetrascience-react-ui required by the chart components — install it in your app (e.g. `yarn add plotly.js-dist`).";let o=null,r=null;function i(){return r??=Promise.resolve().then(()=>d(require("plotly.js-dist"))).then(e=>{const t=e;return o=t.default??t,o}).catch(e=>{throw r=null,console.error(a,e),new Error(a)}),r}function c(){if(!o)throw new Error("Plotly accessed before loadPlotly() resolved. Call loadPlotly() and draw the plot first.");return o}exports.getLoadedPlotly=c;exports.loadPlotly=i;
+//# sourceMappingURL=plotly-loader.cjs.map

package/dist/components/charts/plotly-loader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plotly-loader.cjs","sources":["../../../src/components/charts/plotly-loader.ts"],"sourcesContent":["/**\n * Lazy Plotly loader (SW-2007).\n *\n * The kit ships preserved ES modules with all dependencies externalized, so a\n * static `import Plotly from \"plotly.js-dist\"` in any chart lands the full\n * ~4.7 MB Plotly dist in the consumer's main chunk — before any chart renders.\n * Loading it through this module's dynamic `import()` instead lets consumer\n * bundlers split Plotly into its own chunk, fetched only when a chart mounts.\n *\n * Chart components must call `loadPlotly()` before drawing. Code that only\n * runs after a plot exists (hover handlers, resize relayouts, unmount purges)\n * can use the synchronous `getLoadedPlotly()`.\n *\n * `plotly.js-dist` is an *optional* peer dependency (SW-2007): consumers that\n * use the kit's charts must add it to their own app; consumers that don't\n * never install its ~4.7 MB. A missing peer surfaces at build time as an\n * unresolved-import error from the consumer's bundler; the runtime guard below\n * covers the rarer case where the import resolves but fails to evaluate.\n */\n\ntype PlotlyModule = typeof import(\"plotly.js-dist\");\n\nconst MISSING_PLOTLY_MESSAGE =\n  \"Failed to load 'plotly.js-dist'. It is an optional peer dependency of \" +\n  \"@tetrascience-npm/tetrascience-react-ui required by the chart components — \" +\n  \"install it in your app (e.g. `yarn add plotly.js-dist`).\";\n\nlet loadedPlotly: PlotlyModule | null = null;\nlet plotlyPromise: Promise<PlotlyModule> | null = null;\n\n/** Import Plotly on first use; subsequent calls reuse the same promise. */\nexport function loadPlotly(): Promise<PlotlyModule> {\n  plotlyPromise ??= import(\"plotly.js-dist\")\n    .then((mod) => {\n      // plotly.js-dist is CJS; depending on the consumer's bundler interop the\n      // API surface is either the namespace itself or its `default` export.\n      const withDefault = mod as PlotlyModule & { default?: PlotlyModule };\n      loadedPlotly = withDefault.default ?? withDefault;\n      return loadedPlotly;\n    })\n    .catch((error: unknown) => {\n      // Reset so a later mount can retry, and rethrow with install guidance.\n      plotlyPromise = null;\n      console.error(MISSING_PLOTLY_MESSAGE, error);\n      throw new Error(MISSING_PLOTLY_MESSAGE);\n    });\n  return plotlyPromise;\n}\n\n/**\n * Synchronous access to the loaded Plotly module. Only valid after\n * `loadPlotly()` has resolved — i.e. in code paths that can only run once a\n * plot has been drawn (event handlers, cleanups, resize effects).\n */\nexport function getLoadedPlotly(): PlotlyModule {\n  if (!loadedPlotly) {\n    throw new Error(\n      \"Plotly accessed before loadPlotly() resolved. Call loadPlotly() and draw the plot first.\",\n    );\n  }\n  return loadedPlotly;\n}\n\nexport type { PlotlyModule };\n"],"names":["MISSING_PLOTLY_MESSAGE","loadedPlotly","plotlyPromise","loadPlotly","_interopNamespaceDefault","mod","withDefault","error","getLoadedPlotly"],"mappings":"6VAsBA,MAAMA,EACJ,4MAIF,IAAIC,EAAoC,KACpCC,EAA8C,KAG3C,SAASC,GAAoC,CAClD,OAAAD,IAAkB,QAAA,QAAA,EAAA,KAAA,IAAAE,EAAA,QAAO,gBAAgB,CAAA,CAAA,EACtC,KAAMC,GAAQ,CAGb,MAAMC,EAAcD,EACpB,OAAAJ,EAAeK,EAAY,SAAWA,EAC/BL,CACT,CAAC,EACA,MAAOM,GAAmB,CAEzB,MAAAL,EAAgB,KAChB,QAAQ,MAAMF,EAAwBO,CAAK,EACrC,IAAI,MAAMP,CAAsB,CACxC,CAAC,EACIE,CACT,CAOO,SAASM,GAAgC,CAC9C,GAAI,CAACP,EACH,MAAM,IAAI,MACR,0FAAA,EAGJ,OAAOA,CACT"}