@pibbl/core 0.0.2 → 0.0.3-alpha.85.1

package/dist/features/viz/lib/interval-band-series.js

@@ -0,0 +1,136 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { useNumericPosition } from "./series-position.js";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import {
+  useInternalValueMemoSlot,
+  validateTexturePaint
+} from "@pibbl/core/internal";
+import { opacity } from "./paint.js";
+import {
+  appendCurveForward,
+  appendCurveReverse,
+  curveGeometry,
+  resolveSeriesCurve,
+  validatePairedCurveGeometry
+} from "./curve-definition.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+function accessor(input) {
+  return typeof input === "function" ? input : (datum) => datum[input];
+}
+function fill(value) {
+  if (typeof value === "string" || value instanceof CanvasGradient || value instanceof CanvasPattern)
+    return value;
+  try {
+    validateTexturePaint(value);
+    return value;
+  } catch {
+    throw new TypeError("IntervalBandSeries: invalid fill.");
+  }
+}
+function IntervalBandSeries({
+  data: dataInput,
+  x: xInput,
+  lower: lowerInput,
+  upper: upperInput,
+  xScale: xId,
+  yScale: yId,
+  defined,
+  curve,
+  style: styleInput,
+  ...eventProps
+}) {
+  const xScale = useNumericPosition(xId);
+  const yScale = useContinuousScale(yId).get();
+  const curveDefinition = resolveSeriesCurve(curve);
+  const x = useInternalValueMemoSlot(
+    "vizIntervalBandXAccessor",
+    () => accessor(xInput),
+    [xInput]
+  );
+  const lower = useInternalValueMemoSlot(
+    "vizIntervalBandLowerAccessor",
+    () => accessor(lowerInput),
+    [lowerInput]
+  );
+  const upper = useInternalValueMemoSlot(
+    "vizIntervalBandUpperAccessor",
+    () => accessor(upperInput),
+    [upperInput]
+  );
+  const data = resolveSignalValue(dataInput);
+  if (!Array.isArray(data))
+    throw new TypeError(
+      "IntervalBandSeries data must be an array or a signal containing an array."
+    );
+  const style = resolveSignalValue(styleInput) ?? {};
+  if (style === null || typeof style !== "object" || Array.isArray(style))
+    throw new TypeError("IntervalBandSeries: style must be an object.");
+  const bandFill = fill(resolveSignalValue(style.fill) ?? "#2563eb");
+  const alpha = opacity(
+    resolveSignalValue(style.opacity) ?? 0.2,
+    "IntervalBandSeries"
+  );
+  const cursor = resolveSignalValue(style.cursor);
+  if (cursor !== void 0 && typeof cursor !== "string")
+    throw new TypeError("IntervalBandSeries: cursor must be a string.");
+  const path = new Path2D();
+  let run = [];
+  const closeRun = () => {
+    if (run.length >= 2) {
+      const upper2 = curveGeometry(
+        curveDefinition,
+        run.map(([x2, _lower, value]) => [x2, value])
+      );
+      const lower2 = curveGeometry(
+        curveDefinition,
+        run.map(([x2, value]) => [x2, value])
+      );
+      validatePairedCurveGeometry(upper2, lower2);
+      path.moveTo(upper2.start[0], upper2.start[1]);
+      appendCurveForward(path, upper2);
+      appendCurveReverse(path, lower2);
+      path.closePath();
+    }
+    run = [];
+  };
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) {
+      closeRun();
+      continue;
+    }
+    const xv = x(datum, i, data);
+    const lowerValue = lower(datum, i, data);
+    const upperValue = upper(datum, i, data);
+    if (typeof xv !== "number" || typeof lowerValue !== "number" || typeof upperValue !== "number" || !Number.isFinite(xv) || !Number.isFinite(lowerValue) || !Number.isFinite(upperValue)) {
+      closeRun();
+      continue;
+    }
+    if (lowerValue > upperValue)
+      throw new RangeError(
+        `IntervalBandSeries datum at index ${i} has lower bound above upper bound.`
+      );
+    const point = [
+      xScale.map(xv),
+      yScale.map(lowerValue),
+      yScale.map(upperValue)
+    ];
+    if (!point.every(Number.isFinite)) {
+      closeRun();
+      continue;
+    }
+    run.push(point);
+  }
+  closeRun();
+  return /* @__PURE__ */ jsx(
+    Path,
+    {
+      ...eventProps,
+      style: { d: path, fill: bandFill, opacity: alpha, cursor }
+    }
+  );
+}
+export {
+  IntervalBandSeries
+};
+//# sourceMappingURL=interval-band-series.js.map

package/dist/features/viz/lib/interval-band-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/interval-band-series.tsx"],
+  "sourcesContent": ["import { useNumericPosition } from \"./series-position.js\";\nimport { Path, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  FillStyle,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  SignalValue,\n} from \"@pibbl/core\";\nimport {\n  useInternalValueMemoSlot,\n  validateTexturePaint,\n} from \"@pibbl/core/internal\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { AreaSeriesStyle } from \"./area-series.js\";\nimport { opacity } from \"./paint.js\";\nimport type { LineAccessor, LineCoordinate, LineSeriesProps } from \"./types.js\";\nimport {\n  appendCurveForward,\n  appendCurveReverse,\n  curveGeometry,\n  resolveSeriesCurve,\n  validatePairedCurveGeometry,\n} from \"./curve-definition.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\n\n/**\n * Authored inputs for {@link IntervalBandSeries}.\n *\n * The data, horizontal coordinate, scales, and defined predicate use the same contract as\n * {@link LineSeriesProps}. Each contiguous run of at least two observations draws its upper\n * boundary forward and lower boundary backward.\n *\n * @see {@link AreaSeriesStyle}\n * @see {@link LineSeriesProps}\n */\nexport interface IntervalBandSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Application data supplied directly or through a signal. */\n  readonly data: LineSeriesProps<D>[\"data\"];\n  /** Property key or callback extracting the horizontal coordinate. */\n  readonly x: LineAccessor<D>;\n  /** Property key or callback extracting the lower bound. */\n  readonly lower: LineAccessor<D>;\n  /** Property key or callback extracting the upper bound. */\n  readonly upper: LineAccessor<D>;\n  /** Continuous scale used to map horizontal data coordinates. */\n  readonly xScale: LineSeriesProps<D>[\"xScale\"];\n  /** Continuous scale used to map both data bounds. */\n  readonly yScale: LineSeriesProps<D>[\"yScale\"];\n  /** Selects records that participate in a matching-bounds run. */\n  readonly defined?: LineSeriesProps<D>[\"defined\"];\n  /** Curve used to connect successive matching bounds. */\n  readonly curve?: LineSeriesProps<D>[\"curve\"];\n  /** Shared band presentation. Individual datum styling is not supported. */\n  readonly style?: SignalValue<SignalStyle<AreaSeriesStyle>>;\n}\n\nfunction accessor<D>(\n  input: LineAccessor<D>,\n): (datum: D, index: number, data: readonly D[]) => LineCoordinate {\n  return typeof input === \"function\"\n    ? input\n    : (datum) => datum[input] as LineCoordinate;\n}\n\nfunction fill(value: unknown): FillStyle {\n  if (\n    typeof value === \"string\" ||\n    value instanceof CanvasGradient ||\n    value instanceof CanvasPattern\n  )\n    return value;\n  try {\n    validateTexturePaint(value as never);\n    return value as FillStyle;\n  } catch {\n    throw new TypeError(\"IntervalBandSeries: invalid fill.\");\n  }\n}\n\n/**\n * Draws a filled band between matching lower and upper observations.\n *\n * Missing, non-finite, and excluded coordinates split runs. A lower value above its upper\n * value rejects the datum; equal bounds produce zero-area geometry. The component owns one\n * ordinary {@link Path} target, so event participation follows standard Path defaults.\n *\n * @param props - Data, coordinate accessors, continuous scales, and presentation.\n * @returns A Pibbl path node containing all drawable interval-band runs.\n * @throws When data, presentation, or bounds are invalid.\n *\n * @see {@link IntervalBandSeriesProps}\n */\nexport function IntervalBandSeries<D>({\n  data: dataInput,\n  x: xInput,\n  lower: lowerInput,\n  upper: upperInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  curve,\n  style: styleInput,\n  ...eventProps\n}: IntervalBandSeriesProps<D>) {\n  const xScale = useNumericPosition(xId);\n  const yScale = useContinuousScale(yId).get();\n  const curveDefinition = resolveSeriesCurve(curve);\n  const x = useInternalValueMemoSlot(\n    \"vizIntervalBandXAccessor\",\n    () => accessor(xInput),\n    [xInput],\n  );\n  const lower = useInternalValueMemoSlot(\n    \"vizIntervalBandLowerAccessor\",\n    () => accessor(lowerInput),\n    [lowerInput],\n  );\n  const upper = useInternalValueMemoSlot(\n    \"vizIntervalBandUpperAccessor\",\n    () => accessor(upperInput),\n    [upperInput],\n  );\n  const data = resolveSignalValue(dataInput);\n  if (!Array.isArray(data))\n    throw new TypeError(\n      \"IntervalBandSeries data must be an array or a signal containing an array.\",\n    );\n  const style = resolveSignalValue(styleInput) ?? {};\n  if (style === null || typeof style !== \"object\" || Array.isArray(style))\n    throw new TypeError(\"IntervalBandSeries: style must be an object.\");\n  const bandFill = fill(resolveSignalValue(style.fill) ?? \"#2563eb\");\n  const alpha = opacity(\n    resolveSignalValue(style.opacity) ?? 0.2,\n    \"IntervalBandSeries\",\n  );\n  const cursor = resolveSignalValue(style.cursor);\n  if (cursor !== undefined && typeof cursor !== \"string\")\n    throw new TypeError(\"IntervalBandSeries: cursor must be a string.\");\n\n  const path = new Path2D();\n  let run: (readonly [number, number, number])[] = [];\n  const closeRun = () => {\n    if (run.length >= 2) {\n      const upper = curveGeometry(\n        curveDefinition,\n        run.map(([x, _lower, value]) => [x, value] as const),\n      );\n      const lower = curveGeometry(\n        curveDefinition,\n        run.map(([x, value]) => [x, value] as const),\n      );\n      validatePairedCurveGeometry(upper, lower);\n      path.moveTo(upper.start[0], upper.start[1]);\n      appendCurveForward(path, upper);\n      appendCurveReverse(path, lower);\n      path.closePath();\n    }\n    run = [];\n  };\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) {\n      closeRun();\n      continue;\n    }\n    const xv = x(datum, i, data);\n    const lowerValue = lower(datum, i, data);\n    const upperValue = upper(datum, i, data);\n    if (\n      typeof xv !== \"number\" ||\n      typeof lowerValue !== \"number\" ||\n      typeof upperValue !== \"number\" ||\n      !Number.isFinite(xv) ||\n      !Number.isFinite(lowerValue) ||\n      !Number.isFinite(upperValue)\n    ) {\n      closeRun();\n      continue;\n    }\n    if (lowerValue > upperValue)\n      throw new RangeError(\n        `IntervalBandSeries datum at index ${i} has lower bound above upper bound.`,\n      );\n    const point = [\n      xScale.map(xv),\n      yScale.map(lowerValue),\n      yScale.map(upperValue),\n    ] as const;\n    if (!point.every(Number.isFinite)) {\n      closeRun();\n      continue;\n    }\n    run.push(point);\n  }\n  closeRun();\n  return (\n    <Path\n      {...eventProps}\n      style={{ d: path, fill: bandFill, opacity: alpha, cursor }}\n    />\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["upper", "x", "lower"]
+}

package/dist/features/viz/lib/interval-diamond-series.d.ts

@@ -0,0 +1,43 @@
+import { type FillStyle, type PibblNode, type SignalValue, type StrokeStyle } from "@pibbl/core";
+import { type SignalStyle } from "@pibbl/core/internal";
+import type { IntervalSeriesProps } from "./interval-series.js";
+/** Local-pixel height and shared paint for supplied summary diamonds.
+ * @see {@link IntervalDiamondSeries}
+ */
+export interface IntervalDiamondSeriesStyle {
+    /** Full perpendicular height in local pixels; defaults to 12. Zero hides marks. */
+    readonly height?: number;
+    /** Diamond interior paint; defaults to #087f8c. */
+    readonly fill?: FillStyle;
+    /** Diamond outline paint; defaults to #087f8c. */
+    readonly stroke?: StrokeStyle;
+    /** Visible outline width in local pixels; defaults to 1.5. */
+    readonly strokeWidth?: number;
+    /** Outline targeting width in local pixels; defaults to strokeWidth. */
+    readonly lineInteractionWidth?: number;
+    /** Shared opacity from zero to one; defaults to 1. */
+    readonly opacity?: number;
+    /** Cursor shown over painted diamonds. */
+    readonly cursor?: string;
+}
+/** Supplied summary estimates and bounds placed horizontally at categorical centers.
+ * @see {@link IntervalSeriesProps}
+ * @see {@link IntervalDiamondSeriesStyle}
+ */
+export interface IntervalDiamondSeriesProps<D> extends Omit<IntervalSeriesProps<D>, "style"> {
+    /** Whole-object and shallow field signals are observed; per-datum styling is not supported. */
+    readonly style?: SignalValue<SignalStyle<IntervalDiamondSeriesStyle>>;
+}
+/**
+ * Draw supplied summary estimates as horizontal diamonds; no pooling or inference.
+ * Left/right tips map lower/upper, top/bottom map the estimate. Estimates must
+ * lie inside the supplied bounds. Missing/nonfinite rows and unknown categories
+ * are omitted; reversed bounds and invalid log values reject included rows.
+ * Diamonds share one ordinary Path target; handlers receive ordinary events.
+ * Mapping does not clamp or clip. Compose a Clip when required.
+ *
+ * @param props - Supplied rows, accessors, categorical/value scales, and shared paint.
+ * @returns One batched Pibbl Path containing the supplied diamonds in source order.
+ * @see {@link IntervalDiamondSeriesProps}
+ */
+export declare function IntervalDiamondSeries<D>(props: IntervalDiamondSeriesProps<D>): PibblNode;

package/dist/features/viz/lib/interval-diamond-series.js

@@ -0,0 +1,124 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import {
+  Path,
+  resolveSignalValue
+} from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { lookupScale } from "./scale-context.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import { opacity, width } from "./paint.js";
+function IntervalDiamondSeries(props) {
+  const receiver = "IntervalDiamondSeries";
+  const {
+    data: input,
+    category: categoryInput,
+    estimate: estimateInput,
+    lower: lowerInput,
+    upper: upperInput,
+    categoryScale,
+    valueScale,
+    defined,
+    style: styleInput,
+    ...events
+  } = props;
+  const categories = lookupScale(categoryScale, receiver)?.get();
+  const values = useContinuousScale(valueScale).get();
+  if (!categories || categories.type !== "point" && categories.type !== "band")
+    throw new TypeError(
+      `${receiver}: categoryScale requires PointScale or BarScale.`
+    );
+  const data = pointData(resolveSignalValue(input), receiver);
+  const category = typeof categoryInput === "function" ? categoryInput : (datum) => datum[categoryInput];
+  const estimate = pointAccessor(estimateInput), lower = pointAccessor(lowerInput), upper = pointAccessor(upperInput);
+  const specified = resolveSignalValue(styleInput) ?? {};
+  if (typeof specified !== "object" || Array.isArray(specified))
+    throw new TypeError(`${receiver}: style must be an object.`);
+  const resolved = {};
+  for (const key of Object.keys(specified)) {
+    if (![
+      "height",
+      "fill",
+      "stroke",
+      "strokeWidth",
+      "lineInteractionWidth",
+      "opacity",
+      "cursor"
+    ].includes(key))
+      throw new TypeError(`${receiver}: unsupported style field ${key}.`);
+    resolved[key] = resolveSignalValue(
+      specified[key]
+    );
+  }
+  const style = resolved;
+  const halfHeight = width(style.height ?? 12, `${receiver} height`) / 2;
+  const strokeWidth = width(style.strokeWidth ?? 1.5, receiver);
+  const lineInteractionWidth = width(
+    style.lineInteractionWidth ?? strokeWidth,
+    receiver
+  );
+  const alpha = opacity(style.opacity ?? 1, receiver);
+  if (style.cursor !== void 0 && typeof style.cursor !== "string")
+    throw new TypeError(`${receiver}: cursor must be a string.`);
+  const path = new Path2D();
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    const row = withHooksForbidden(
+      `${receiver}: accessors cannot call hooks.`,
+      () => {
+        if (defined && !defined(datum, i, data)) return void 0;
+        return {
+          category: category(datum, i, data),
+          estimate: estimate(datum, i, data),
+          lower: lower(datum, i, data),
+          upper: upper(datum, i, data)
+        };
+      }
+    );
+    if (!row || row.category == null || !finiteCoordinate(row.estimate) || !finiteCoordinate(row.lower) || !finiteCoordinate(row.upper))
+      continue;
+    const start = categories.map(row.category);
+    if (start === void 0) continue;
+    if (row.lower > row.upper)
+      throw new RangeError(
+        `${receiver}: lower must not exceed upper (row ${i}).`
+      );
+    if (row.estimate < row.lower || row.estimate > row.upper)
+      throw new RangeError(
+        `${receiver}: estimate must lie inside supplied bounds (row ${i}).`
+      );
+    const center = start + (categories.type === "band" ? categories.bandwidth / 2 : 0);
+    const lo = values.map(row.lower), hi = values.map(row.upper), point = values.map(row.estimate);
+    if (![center - halfHeight, center + halfHeight, lo, hi, point].every(
+      Number.isFinite
+    ))
+      throw new RangeError(
+        `${receiver}: mapped coordinates must be finite (row ${i}).`
+      );
+    if (halfHeight === 0) continue;
+    path.moveTo(lo, center);
+    path.lineTo(point, center - halfHeight);
+    path.lineTo(hi, center);
+    path.lineTo(point, center + halfHeight);
+    path.closePath();
+  }
+  return /* @__PURE__ */ jsx(
+    Path,
+    {
+      ...events,
+      style: {
+        d: path,
+        fill: style.fill ?? "#087f8c",
+        stroke: style.stroke ?? "#087f8c",
+        strokeWidth,
+        lineInteractionWidth,
+        opacity: alpha,
+        cursor: style.cursor
+      }
+    }
+  );
+}
+export {
+  IntervalDiamondSeries
+};
+//# sourceMappingURL=interval-diamond-series.js.map

package/dist/features/viz/lib/interval-diamond-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/interval-diamond-series.tsx"],
+  "sourcesContent": ["import {\n  Path,\n  resolveSignalValue,\n  type FillStyle,\n  type PibblNode,\n  type SignalValue,\n  type StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden, type SignalStyle } from \"@pibbl/core/internal\";\nimport type { IntervalSeriesProps } from \"./interval-series.js\";\nimport type { BandCategory } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\n\n/** Local-pixel height and shared paint for supplied summary diamonds.\n * @see {@link IntervalDiamondSeries}\n */\nexport interface IntervalDiamondSeriesStyle {\n  /** Full perpendicular height in local pixels; defaults to 12. Zero hides marks. */\n  readonly height?: number;\n  /** Diamond interior paint; defaults to #087f8c. */\n  readonly fill?: FillStyle;\n  /** Diamond outline paint; defaults to #087f8c. */\n  readonly stroke?: StrokeStyle;\n  /** Visible outline width in local pixels; defaults to 1.5. */\n  readonly strokeWidth?: number;\n  /** Outline targeting width in local pixels; defaults to strokeWidth. */\n  readonly lineInteractionWidth?: number;\n  /** Shared opacity from zero to one; defaults to 1. */\n  readonly opacity?: number;\n  /** Cursor shown over painted diamonds. */\n  readonly cursor?: string;\n}\n\n/** Supplied summary estimates and bounds placed horizontally at categorical centers.\n * @see {@link IntervalSeriesProps}\n * @see {@link IntervalDiamondSeriesStyle}\n */\nexport interface IntervalDiamondSeriesProps<D> extends Omit<\n  IntervalSeriesProps<D>,\n  \"style\"\n> {\n  /** Whole-object and shallow field signals are observed; per-datum styling is not supported. */\n  readonly style?: SignalValue<SignalStyle<IntervalDiamondSeriesStyle>>;\n}\n\n/**\n * Draw supplied summary estimates as horizontal diamonds; no pooling or inference.\n * Left/right tips map lower/upper, top/bottom map the estimate. Estimates must\n * lie inside the supplied bounds. Missing/nonfinite rows and unknown categories\n * are omitted; reversed bounds and invalid log values reject included rows.\n * Diamonds share one ordinary Path target; handlers receive ordinary events.\n * Mapping does not clamp or clip. Compose a Clip when required.\n *\n * @param props - Supplied rows, accessors, categorical/value scales, and shared paint.\n * @returns One batched Pibbl Path containing the supplied diamonds in source order.\n * @see {@link IntervalDiamondSeriesProps}\n */\nexport function IntervalDiamondSeries<D>(\n  props: IntervalDiamondSeriesProps<D>,\n): PibblNode {\n  const receiver = \"IntervalDiamondSeries\";\n  const {\n    data: input,\n    category: categoryInput,\n    estimate: estimateInput,\n    lower: lowerInput,\n    upper: upperInput,\n    categoryScale,\n    valueScale,\n    defined,\n    style: styleInput,\n    ...events\n  } = props;\n  const categories = lookupScale(categoryScale, receiver)?.get();\n  const values = useContinuousScale(valueScale).get();\n  if (\n    !categories ||\n    (categories.type !== \"point\" && categories.type !== \"band\")\n  )\n    throw new TypeError(\n      `${receiver}: categoryScale requires PointScale or BarScale.`,\n    );\n  const data = pointData(resolveSignalValue(input), receiver);\n  const category =\n    typeof categoryInput === \"function\"\n      ? categoryInput\n      : (datum: D) => datum[categoryInput] as BandCategory | null | undefined;\n  const estimate = pointAccessor(estimateInput),\n    lower = pointAccessor(lowerInput),\n    upper = pointAccessor(upperInput);\n  const specified = resolveSignalValue(styleInput) ?? {};\n  if (typeof specified !== \"object\" || Array.isArray(specified))\n    throw new TypeError(`${receiver}: style must be an object.`);\n  const resolved: Record<string, unknown> = {};\n  for (const key of Object.keys(specified)) {\n    if (\n      ![\n        \"height\",\n        \"fill\",\n        \"stroke\",\n        \"strokeWidth\",\n        \"lineInteractionWidth\",\n        \"opacity\",\n        \"cursor\",\n      ].includes(key)\n    )\n      throw new TypeError(`${receiver}: unsupported style field ${key}.`);\n    resolved[key] = resolveSignalValue(\n      specified[key as keyof typeof specified],\n    );\n  }\n  const style = resolved as IntervalDiamondSeriesStyle;\n  const halfHeight = width(style.height ?? 12, `${receiver} height`) / 2;\n  const strokeWidth = width(style.strokeWidth ?? 1.5, receiver);\n  const lineInteractionWidth = width(\n    style.lineInteractionWidth ?? strokeWidth,\n    receiver,\n  );\n  const alpha = opacity(style.opacity ?? 1, receiver);\n  if (style.cursor !== undefined && typeof style.cursor !== \"string\")\n    throw new TypeError(`${receiver}: cursor must be a string.`);\n  const path = new Path2D();\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    const row = withHooksForbidden(\n      `${receiver}: accessors cannot call hooks.`,\n      () => {\n        if (defined && !defined(datum, i, data)) return undefined;\n        return {\n          category: category(datum, i, data),\n          estimate: estimate(datum, i, data),\n          lower: lower(datum, i, data),\n          upper: upper(datum, i, data),\n        };\n      },\n    );\n    if (\n      !row ||\n      row.category == null ||\n      !finiteCoordinate(row.estimate) ||\n      !finiteCoordinate(row.lower) ||\n      !finiteCoordinate(row.upper)\n    )\n      continue;\n    const start = categories.map(row.category);\n    if (start === undefined) continue;\n    if (row.lower > row.upper)\n      throw new RangeError(\n        `${receiver}: lower must not exceed upper (row ${i}).`,\n      );\n    if (row.estimate < row.lower || row.estimate > row.upper)\n      throw new RangeError(\n        `${receiver}: estimate must lie inside supplied bounds (row ${i}).`,\n      );\n    const center =\n      start + (categories.type === \"band\" ? categories.bandwidth / 2 : 0);\n    const lo = values.map(row.lower),\n      hi = values.map(row.upper),\n      point = values.map(row.estimate);\n    if (\n      ![center - halfHeight, center + halfHeight, lo, hi, point].every(\n        Number.isFinite,\n      )\n    )\n      throw new RangeError(\n        `${receiver}: mapped coordinates must be finite (row ${i}).`,\n      );\n    if (halfHeight === 0) continue;\n    path.moveTo(lo, center);\n    path.lineTo(point, center - halfHeight);\n    path.lineTo(hi, center);\n    path.lineTo(point, center + halfHeight);\n    path.closePath();\n  }\n  return (\n    <Path\n      {...events}\n      style={{\n        d: path,\n        fill: style.fill ?? \"#087f8c\",\n        stroke: style.stroke ?? \"#087f8c\",\n        strokeWidth,\n        lineInteractionWidth,\n        opacity: alpha,\n        cursor: style.cursor,\n      }}\n    />\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/viz/lib/interval-series.d.ts

@@ -0,0 +1,79 @@
+import type { FillStyle, PibblEventHandlers, PibblEventParticipationOptions, PibblNode, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { BarCategoryAccessor } from "./bar-series.js";
+import type { LineAccessor, ScaleId } from "./types.js";
+/** Shared local-pixel geometry and paint for estimate-and-interval marks.
+ * @see {@link IntervalSeriesProps}
+ */
+export interface IntervalSeriesStyle {
+    /** Estimate circle radius in local pixels; defaults to 4. */
+    readonly radius?: number;
+    /** Full perpendicular length of each endpoint cap; defaults to 8 pixels. */
+    readonly capSize?: number;
+    /** Estimate circle fill; defaults to #087f8c. */
+    readonly fill?: FillStyle;
+    /** Interval, cap, and circle outline paint; defaults to #087f8c. */
+    readonly stroke?: StrokeStyle;
+    /** Visible stroke width in local pixels; defaults to 1.5. */
+    readonly strokeWidth?: number;
+    /** Stroke targeting width, independent of visible width; defaults to strokeWidth. */
+    readonly lineInteractionWidth?: number;
+    /** Shared paint opacity from zero to one; defaults to 1. */
+    readonly opacity?: number;
+    /** Cursor for painted mark targets. */
+    readonly cursor?: string;
+}
+/** Explicit supplied estimates and numeric bounds placed at categorical centers.
+ * @see {@link HorizontalIntervalSeries}
+ * @see {@link VerticalIntervalSeries}
+ */
+export interface IntervalSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Original records, or a signal of records; no estimation is performed. */
+    readonly data: SignalValue<readonly D[]>;
+    /** Property or callback supplying a category; missing/unknown categories omit rows. */
+    readonly category: BarCategoryAccessor<D>;
+    /** Property or callback supplying the numeric point estimate. */
+    readonly estimate: LineAccessor<D>;
+    /** Property or callback supplying the numeric lower bound. */
+    readonly lower: LineAccessor<D>;
+    /** Property or callback supplying the numeric upper bound. */
+    readonly upper: LineAccessor<D>;
+    /** Ancestor PointScale or BarScale; band categories use their centers. */
+    readonly categoryScale: ScaleId;
+    /** Ancestor continuous numeric scale mapping estimate and both bounds independently. */
+    readonly valueScale: ScaleId;
+    /** Optional synchronous predicate; excluded rows contribute no marks.
+     * @param datum - Original record being tested.
+     * @param index - Source index of the record.
+     * @param data - Complete supplied data array.
+     * @returns Whether to include this record's estimate and interval.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Shared style; whole-object and shallow field signals are observed by the series. */
+    readonly style?: SignalValue<SignalStyle<IntervalSeriesStyle>>;
+}
+/** Horizontal estimate-and-interval authoring inputs. See {@link HorizontalIntervalSeries}. */
+export type HorizontalIntervalSeriesProps<D> = IntervalSeriesProps<D>;
+/** Vertical estimate-and-interval authoring inputs. See {@link VerticalIntervalSeries}. */
+export type VerticalIntervalSeriesProps<D> = IntervalSeriesProps<D>;
+/**
+ * Draw supplied numeric intervals horizontally with an estimate circle per category.
+ * Missing/non-finite coordinates omit the entire row; reversed bounds reject it.
+ * Mapping does not clamp or clip; compose a Clip when required. Marks use ordinary
+ * Line/Circle targets, with series handlers receiving their bubbled events.
+ *
+ * @param props - Supplied data, categorical/numeric scale IDs, and shared style.
+ * @returns Ordinary Pibbl content in source order, interval then circle for each row.
+ * @see {@link HorizontalIntervalSeriesProps}
+ */
+export declare function HorizontalIntervalSeries<D>(props: HorizontalIntervalSeriesProps<D>): PibblNode;
+/**
+ * Draw supplied numeric intervals vertically with an estimate circle per category.
+ * Shares the missing-data, bounds, paint, targeting, and clipping contract of
+ * HorizontalIntervalSeries; orientation is explicit in the operation name.
+ *
+ * @param props - Supplied data, categorical/numeric scale IDs, and shared style.
+ * @returns Ordinary Pibbl content in source order, interval then circle for each row.
+ * @see {@link VerticalIntervalSeriesProps}
+ */
+export declare function VerticalIntervalSeries<D>(props: VerticalIntervalSeriesProps<D>): PibblNode;

package/dist/features/viz/lib/interval-series.js

@@ -0,0 +1,158 @@
+import { Fragment, jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import { Circle, Group, Line, resolveSignalValue } from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { lookupScale } from "./scale-context.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import { opacity, width } from "./paint.js";
+function intervalSeries(props, horizontal) {
+  const receiver = horizontal ? "HorizontalIntervalSeries" : "VerticalIntervalSeries";
+  const {
+    data: input,
+    category: categoryInput,
+    estimate: estimateInput,
+    lower: lowerInput,
+    upper: upperInput,
+    categoryScale,
+    valueScale,
+    defined,
+    style: styleInput,
+    pointerEvents,
+    ...events
+  } = props;
+  const categories = lookupScale(categoryScale, receiver)?.get();
+  const values = useContinuousScale(valueScale).get();
+  if (!categories || categories.type !== "point" && categories.type !== "band")
+    throw new TypeError(
+      `${receiver}: categoryScale requires PointScale or BarScale.`
+    );
+  const data = pointData(resolveSignalValue(input), receiver);
+  const category = typeof categoryInput === "function" ? categoryInput : (datum) => datum[categoryInput];
+  const estimate = pointAccessor(estimateInput), lower = pointAccessor(lowerInput), upper = pointAccessor(upperInput);
+  const specified = resolveSignalValue(styleInput) ?? {};
+  if (typeof specified !== "object" || Array.isArray(specified))
+    throw new TypeError(`${receiver}: style must be an object.`);
+  const style = {};
+  for (const key of Object.keys(specified)) {
+    if (![
+      "radius",
+      "capSize",
+      "fill",
+      "stroke",
+      "strokeWidth",
+      "lineInteractionWidth",
+      "opacity",
+      "cursor"
+    ].includes(key))
+      throw new TypeError(`${receiver}: unsupported style field ${key}.`);
+    style[key] = resolveSignalValue(specified[key]);
+  }
+  const resolved = style;
+  const radius = width(resolved.radius ?? 4, `${receiver} radius`);
+  const halfCap = width(resolved.capSize ?? 8, `${receiver} capSize`) / 2;
+  const strokeWidth = width(resolved.strokeWidth ?? 1.5, receiver);
+  const lineInteractionWidth = width(
+    resolved.lineInteractionWidth ?? strokeWidth,
+    receiver
+  );
+  const alpha = opacity(resolved.opacity ?? 1, receiver);
+  if (resolved.cursor !== void 0 && typeof resolved.cursor !== "string")
+    throw new TypeError(`${receiver}: cursor must be a string.`);
+  const stroke = resolved.stroke ?? "#087f8c";
+  const lineStyle = {
+    stroke,
+    strokeWidth,
+    lineInteractionWidth,
+    opacity: alpha,
+    cursor: resolved.cursor
+  };
+  const nodes = [];
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    const coordinates = withHooksForbidden(
+      `${receiver}: accessors cannot call hooks.`,
+      () => {
+        if (defined && !defined(datum, i, data)) return void 0;
+        return {
+          category: category(datum, i, data),
+          estimate: estimate(datum, i, data),
+          lower: lower(datum, i, data),
+          upper: upper(datum, i, data)
+        };
+      }
+    );
+    if (!coordinates || coordinates.category == null || !finiteCoordinate(coordinates.estimate) || !finiteCoordinate(coordinates.lower) || !finiteCoordinate(coordinates.upper))
+      continue;
+    const start = categories.map(coordinates.category);
+    if (start === void 0) continue;
+    if (coordinates.lower > coordinates.upper)
+      throw new RangeError(
+        `${receiver}: lower must not exceed upper (row ${i}).`
+      );
+    const center = start + (categories.type === "band" ? categories.bandwidth / 2 : 0);
+    const lo = values.map(coordinates.lower), hi = values.map(coordinates.upper), point = values.map(coordinates.estimate);
+    if (![center, lo, hi, point].every(Number.isFinite))
+      throw new RangeError(
+        `${receiver}: mapped coordinates must be finite (row ${i}).`
+      );
+    const position = (value, offset = 0) => horizontal ? [value, center + offset] : [center + offset, value];
+    nodes.push(
+      /* @__PURE__ */ jsxs(Group, { children: [
+        /* @__PURE__ */ jsx(
+          Line,
+          {
+            pointerEvents,
+            style: { ...lineStyle, coords: [position(lo), position(hi)] }
+          }
+        ),
+        halfCap > 0 && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(
+            Line,
+            {
+              pointerEvents,
+              style: {
+                ...lineStyle,
+                coords: [position(lo, -halfCap), position(lo, halfCap)]
+              }
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            Line,
+            {
+              pointerEvents,
+              style: {
+                ...lineStyle,
+                coords: [position(hi, -halfCap), position(hi, halfCap)]
+              }
+            }
+          )
+        ] }),
+        radius > 0 && /* @__PURE__ */ jsx(
+          Circle,
+          {
+            pointerEvents,
+            style: {
+              ...lineStyle,
+              cx: horizontal ? point : center,
+              cy: horizontal ? center : point,
+              radius,
+              fill: resolved.fill ?? "#087f8c"
+            }
+          }
+        )
+      ] }, i)
+    );
+  }
+  return /* @__PURE__ */ jsx(Group, { ...events, children: nodes });
+}
+function HorizontalIntervalSeries(props) {
+  return intervalSeries(props, true);
+}
+function VerticalIntervalSeries(props) {
+  return intervalSeries(props, false);
+}
+export {
+  HorizontalIntervalSeries,
+  VerticalIntervalSeries
+};
+//# sourceMappingURL=interval-series.js.map

package/dist/features/viz/lib/interval-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/interval-series.tsx"],
+  "sourcesContent": ["import { Circle, Group, Line, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  FillStyle,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  PibblNode,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { BarCategoryAccessor } from \"./bar-series.js\";\nimport type { BandCategory, LineAccessor, ScaleId } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\n\n/** Shared local-pixel geometry and paint for estimate-and-interval marks.\n * @see {@link IntervalSeriesProps}\n */\nexport interface IntervalSeriesStyle {\n  /** Estimate circle radius in local pixels; defaults to 4. */\n  readonly radius?: number;\n  /** Full perpendicular length of each endpoint cap; defaults to 8 pixels. */\n  readonly capSize?: number;\n  /** Estimate circle fill; defaults to #087f8c. */\n  readonly fill?: FillStyle;\n  /** Interval, cap, and circle outline paint; defaults to #087f8c. */\n  readonly stroke?: StrokeStyle;\n  /** Visible stroke width in local pixels; defaults to 1.5. */\n  readonly strokeWidth?: number;\n  /** Stroke targeting width, independent of visible width; defaults to strokeWidth. */\n  readonly lineInteractionWidth?: number;\n  /** Shared paint opacity from zero to one; defaults to 1. */\n  readonly opacity?: number;\n  /** Cursor for painted mark targets. */\n  readonly cursor?: string;\n}\n\n/** Explicit supplied estimates and numeric bounds placed at categorical centers.\n * @see {@link HorizontalIntervalSeries}\n * @see {@link VerticalIntervalSeries}\n */\nexport interface IntervalSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Original records, or a signal of records; no estimation is performed. */\n  readonly data: SignalValue<readonly D[]>;\n  /** Property or callback supplying a category; missing/unknown categories omit rows. */\n  readonly category: BarCategoryAccessor<D>;\n  /** Property or callback supplying the numeric point estimate. */\n  readonly estimate: LineAccessor<D>;\n  /** Property or callback supplying the numeric lower bound. */\n  readonly lower: LineAccessor<D>;\n  /** Property or callback supplying the numeric upper bound. */\n  readonly upper: LineAccessor<D>;\n  /** Ancestor PointScale or BarScale; band categories use their centers. */\n  readonly categoryScale: ScaleId;\n  /** Ancestor continuous numeric scale mapping estimate and both bounds independently. */\n  readonly valueScale: ScaleId;\n  /** Optional synchronous predicate; excluded rows contribute no marks.\n   * @param datum - Original record being tested.\n   * @param index - Source index of the record.\n   * @param data - Complete supplied data array.\n   * @returns Whether to include this record's estimate and interval.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Shared style; whole-object and shallow field signals are observed by the series. */\n  readonly style?: SignalValue<SignalStyle<IntervalSeriesStyle>>;\n}\n\n/** Horizontal estimate-and-interval authoring inputs. See {@link HorizontalIntervalSeries}. */\nexport type HorizontalIntervalSeriesProps<D> = IntervalSeriesProps<D>;\n/** Vertical estimate-and-interval authoring inputs. See {@link VerticalIntervalSeries}. */\nexport type VerticalIntervalSeriesProps<D> = IntervalSeriesProps<D>;\n\nfunction intervalSeries<D>(\n  props: IntervalSeriesProps<D>,\n  horizontal: boolean,\n): PibblNode {\n  const receiver = horizontal\n    ? \"HorizontalIntervalSeries\"\n    : \"VerticalIntervalSeries\";\n  const {\n    data: input,\n    category: categoryInput,\n    estimate: estimateInput,\n    lower: lowerInput,\n    upper: upperInput,\n    categoryScale,\n    valueScale,\n    defined,\n    style: styleInput,\n    pointerEvents,\n    ...events\n  } = props;\n  const categories = lookupScale(categoryScale, receiver)?.get();\n  const values = useContinuousScale(valueScale).get();\n  if (\n    !categories ||\n    (categories.type !== \"point\" && categories.type !== \"band\")\n  )\n    throw new TypeError(\n      `${receiver}: categoryScale requires PointScale or BarScale.`,\n    );\n  const data = pointData(resolveSignalValue(input), receiver);\n  const category =\n    typeof categoryInput === \"function\"\n      ? categoryInput\n      : (datum: D) => datum[categoryInput] as BandCategory | null | undefined;\n  const estimate = pointAccessor(estimateInput),\n    lower = pointAccessor(lowerInput),\n    upper = pointAccessor(upperInput);\n  const specified = resolveSignalValue(styleInput) ?? {};\n  if (typeof specified !== \"object\" || Array.isArray(specified))\n    throw new TypeError(`${receiver}: style must be an object.`);\n  const style: Record<string, unknown> = {};\n  for (const key of Object.keys(specified)) {\n    if (\n      ![\n        \"radius\",\n        \"capSize\",\n        \"fill\",\n        \"stroke\",\n        \"strokeWidth\",\n        \"lineInteractionWidth\",\n        \"opacity\",\n        \"cursor\",\n      ].includes(key)\n    )\n      throw new TypeError(`${receiver}: unsupported style field ${key}.`);\n    style[key] = resolveSignalValue(specified[key as keyof typeof specified]);\n  }\n  const resolved = style as IntervalSeriesStyle;\n  const radius = width(resolved.radius ?? 4, `${receiver} radius`);\n  const halfCap = width(resolved.capSize ?? 8, `${receiver} capSize`) / 2;\n  const strokeWidth = width(resolved.strokeWidth ?? 1.5, receiver);\n  const lineInteractionWidth = width(\n    resolved.lineInteractionWidth ?? strokeWidth,\n    receiver,\n  );\n  const alpha = opacity(resolved.opacity ?? 1, receiver);\n  if (resolved.cursor !== undefined && typeof resolved.cursor !== \"string\")\n    throw new TypeError(`${receiver}: cursor must be a string.`);\n  const stroke = resolved.stroke ?? \"#087f8c\";\n  const lineStyle = {\n    stroke,\n    strokeWidth,\n    lineInteractionWidth,\n    opacity: alpha,\n    cursor: resolved.cursor,\n  };\n  const nodes: PibblNode[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    const coordinates = withHooksForbidden(\n      `${receiver}: accessors cannot call hooks.`,\n      () => {\n        if (defined && !defined(datum, i, data)) return undefined;\n        return {\n          category: category(datum, i, data),\n          estimate: estimate(datum, i, data),\n          lower: lower(datum, i, data),\n          upper: upper(datum, i, data),\n        };\n      },\n    );\n    if (\n      !coordinates ||\n      coordinates.category == null ||\n      !finiteCoordinate(coordinates.estimate) ||\n      !finiteCoordinate(coordinates.lower) ||\n      !finiteCoordinate(coordinates.upper)\n    )\n      continue;\n    const start = categories.map(coordinates.category);\n    if (start === undefined) continue;\n    if (coordinates.lower > coordinates.upper)\n      throw new RangeError(\n        `${receiver}: lower must not exceed upper (row ${i}).`,\n      );\n    const center =\n      start + (categories.type === \"band\" ? categories.bandwidth / 2 : 0);\n    const lo = values.map(coordinates.lower),\n      hi = values.map(coordinates.upper),\n      point = values.map(coordinates.estimate);\n    if (![center, lo, hi, point].every(Number.isFinite))\n      throw new RangeError(\n        `${receiver}: mapped coordinates must be finite (row ${i}).`,\n      );\n    const position = (value: number, offset = 0): [number, number] =>\n      horizontal ? [value, center + offset] : [center + offset, value];\n    nodes.push(\n      <Group key={i}>\n        <Line\n          pointerEvents={pointerEvents}\n          style={{ ...lineStyle, coords: [position(lo), position(hi)] }}\n        />\n        {halfCap > 0 && (\n          <>\n            <Line\n              pointerEvents={pointerEvents}\n              style={{\n                ...lineStyle,\n                coords: [position(lo, -halfCap), position(lo, halfCap)],\n              }}\n            />\n            <Line\n              pointerEvents={pointerEvents}\n              style={{\n                ...lineStyle,\n                coords: [position(hi, -halfCap), position(hi, halfCap)],\n              }}\n            />\n          </>\n        )}\n        {radius > 0 && (\n          <Circle\n            pointerEvents={pointerEvents}\n            style={{\n              ...lineStyle,\n              cx: horizontal ? point : center,\n              cy: horizontal ? center : point,\n              radius,\n              fill: resolved.fill ?? \"#087f8c\",\n            }}\n          />\n        )}\n      </Group>,\n    );\n  }\n  return <Group {...events}>{nodes}</Group>;\n}\n\n/**\n * Draw supplied numeric intervals horizontally with an estimate circle per category.\n * Missing/non-finite coordinates omit the entire row; reversed bounds reject it.\n * Mapping does not clamp or clip; compose a Clip when required. Marks use ordinary\n * Line/Circle targets, with series handlers receiving their bubbled events.\n *\n * @param props - Supplied data, categorical/numeric scale IDs, and shared style.\n * @returns Ordinary Pibbl content in source order, interval then circle for each row.\n * @see {@link HorizontalIntervalSeriesProps}\n */\nexport function HorizontalIntervalSeries<D>(\n  props: HorizontalIntervalSeriesProps<D>,\n): PibblNode {\n  return intervalSeries(props, true);\n}\n\n/**\n * Draw supplied numeric intervals vertically with an estimate circle per category.\n * Shares the missing-data, bounds, paint, targeting, and clipping contract of\n * HorizontalIntervalSeries; orientation is explicit in the operation name.\n *\n * @param props - Supplied data, categorical/numeric scale IDs, and shared style.\n * @returns Ordinary Pibbl content in source order, interval then circle for each row.\n * @see {@link VerticalIntervalSeriesProps}\n */\nexport function VerticalIntervalSeries<D>(\n  props: VerticalIntervalSeriesProps<D>,\n): PibblNode {\n  return intervalSeries(props, false);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/viz/lib/line-series.d.ts

@@ -8,4 +8,4 @@ import type { LineSeriesProps } from "./types.js";
  *
  * @see {@link LineSeriesProps}
  */
-export declare function LineSeries<D>({ data: dataInput, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, curve, style: styleInput, ...eventProps }: LineSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;
+export declare function LineSeries<D>({ data: dataInput, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, inspection, curve, style: styleInput, ...eventProps }: LineSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;