@opendata-ai/openchart-engine 8.0.0-rc.22 → 8.0.0-rc.24

package/dist/index.js

@@ -11044,6 +11044,40 @@ function validateMarkRenderMode(spec, errors) {
     });
   }
 }
+var MAX_PLAUSIBLE_POINT_RADIUS = 50;
+function pointSizeError(path2, value2) {
+  const radius = Math.max(1, Math.round(Math.sqrt(value2 / Math.PI)));
+  return {
+    message: `Spec error: ${path2} is a radius in pixels, and ${value2} would draw a ${Math.round(value2 * 2)}px-wide circle. This usually means the value was written in Vega-Lite's units, where point size is an area in px^2.`,
+    path: path2,
+    code: "INVALID_VALUE",
+    suggestion: `Point sizes are radii in px (default 5, typical 2-12). For the dot a Vega-Lite size of ${value2} draws, use ${radius} (r = sqrt(area / pi)).`
+  };
+}
+function validatePointSize(spec, errors) {
+  const markType = typeof spec.mark === "string" ? spec.mark : spec.mark?.type;
+  if (markType !== "point") return;
+  if (spec.mark && typeof spec.mark === "object") {
+    const size = spec.mark.size;
+    if (typeof size === "number" && size > MAX_PLAUSIBLE_POINT_RADIUS) {
+      errors.push(pointSizeError("mark.size", size));
+    }
+  }
+  const sizeEnc = spec.encoding && typeof spec.encoding === "object" ? spec.encoding.size : void 0;
+  if (!sizeEnc || typeof sizeEnc !== "object") return;
+  if (typeof sizeEnc.value === "number" && sizeEnc.value > MAX_PLAUSIBLE_POINT_RADIUS) {
+    errors.push(pointSizeError("encoding.size.value", sizeEnc.value));
+  }
+  const range3 = sizeEnc.scale && typeof sizeEnc.scale === "object" ? sizeEnc.scale.range : void 0;
+  if (Array.isArray(range3)) {
+    const worst = range3.find(
+      (entry) => typeof entry === "number" && entry > MAX_PLAUSIBLE_POINT_RADIUS
+    );
+    if (typeof worst === "number") {
+      errors.push(pointSizeError("encoding.size.scale.range", worst));
+    }
+  }
+}
 function validateChartSpec(spec, errors) {
   const markType = typeof spec.mark === "string" ? spec.mark : spec.mark?.type;
   if (!Array.isArray(spec.data)) {
@@ -11150,6 +11184,7 @@ function validateChartSpec(spec, errors) {
     validateCalendarSpec(spec, errors);
   }
   validateMarkRenderMode(spec, errors);
+  validatePointSize(spec, errors);
   if (Array.isArray(spec.transform)) {
     const transforms = spec.transform;
     for (let i = 0; i < transforms.length; i++) {