PointSeries

Read as Markdown

Import from @pibbl/core/viz. Supply data, x, y, xScale, and yScale as for LineSeries. Invalid coordinates skip independent marks; defined runs first. Data may be a signal. Arrays and nested row values are never implicitly unwrapped.

The default dot has radius 3 logical units and fill #2563eb. Style accepts radius, fill, stroke, strokeWidth (default 1), opacity (default 1), and cursor. Use fill: "" for stroke-only rings. Zero radius paints and targets nothing; opacity zero keeps geometry. Widths/radii are finite and nonnegative.

A shared style supports shallow signals. Alternatively, style(datum,index,data) returns plain PointMarkStyle values; explicit signal reads are supported, but nested returned signals and per-datum cursors are not. Points paint fill then stroke in source order, preserving translucent overlap. One logical target covers the union of dots/rings, with normal Pibbl handlers and pointerEvents.

Use PlotSeries for custom Pibbl elements and nearestPoint for explicit inspection. No implicit clipping, sorting, domain inference, or per-point focus is added.

Numeric and categorical positions use SeriesAccessor<D> with continuous scales or PointScale. See categorical position contracts.

API details from source

PointSeries

Batched circles in source paint order with one ordinary Pibbl target.

PointSeries: <D>({ data: input, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, style: styleInput, ...events }: PointSeriesProps<D>) => JSX.Element

Related API: PointSeries, PointSeriesProps, JSX.

Parameters

• props — Data, coordinate accessors, scales, and point styling. See PointSeriesProps .

Returns

Pibbl nodes drawing the point marks.

See also

PointSeriesProps

View source — packages/core/src/features/viz/lib/point-series.tsx:74

PointAccessor

A data property or callback extracting a point coordinate.

type PointAccessor<D> = LineAccessor<D>

Related API: PointAccessor, LineAccessor.

See also

LineAccessor

PointSeriesProps

PlotSeriesProps

View source — packages/core/src/features/viz/lib/point-types.ts:19

PointMarkStyle

Radius and paint applied to an individual plotted point.

interface PointMarkStyle

Related API: PointMarkStyle.

See also

FillStyle

StrokeStyle

PointSeriesStyle

PointStyleResolver

View source — packages/core/src/features/viz/lib/point-types.ts:28

Properties and methods

radius (optional)

readonly radius?: number | undefined

Radius in the coordinate system of this geometry or effect. See PointMarkStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:30

fill (optional)

readonly fill?: FillStyle | undefined

Related API: FillStyle.

Paint used for the interior. See FillStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:32

stroke (optional)

readonly stroke?: StrokeStyle | undefined

Related API: StrokeStyle.

Paint used for the outline. See StrokeStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:34

strokeWidth (optional)

readonly strokeWidth?: number | undefined

Width of the painted outline. See PointMarkStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:36

opacity (optional)

readonly opacity?: number | undefined

Related API: opacity.

Opacity of the painted result. See PointMarkStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:38

PointSeriesStyle

Supported geometry and presentation properties for PointSeries.

interface PointSeriesStyle extends PointMarkStyle

Related API: PointSeriesStyle, PointMarkStyle.

See also

PointMarkStyle

PointSeriesProps

View source — packages/core/src/features/viz/lib/point-types.ts:46

Properties and methods

cursor (optional)

readonly cursor?: string | undefined

Cursor shown while this target owns pointer presentation. See PointSeriesStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:48

radius (optional)

readonly radius?: number | undefined

Radius in the coordinate system of this geometry or effect. See PointMarkStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:30

fill (optional)

readonly fill?: FillStyle | undefined

Related API: FillStyle.

Paint used for the interior. See FillStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:32

stroke (optional)

readonly stroke?: StrokeStyle | undefined

Related API: StrokeStyle.

Paint used for the outline. See StrokeStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:34

strokeWidth (optional)

readonly strokeWidth?: number | undefined

Width of the painted outline. See PointMarkStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:36

opacity (optional)

readonly opacity?: number | undefined

Related API: opacity.

Opacity of the painted result. See PointMarkStyle.

View source — packages/core/src/features/viz/lib/point-types.ts:38

PointStyleResolver

Computes per-datum point styling from the datum, index, and source data.

type PointStyleResolver<D> = (
  datum: D,
  index: number,
  data: readonly D[],
) => Readonly<PointMarkStyle>

Related API: PointStyleResolver, PointMarkStyle.

Parameters

• datum — Datum being styled.

• index — Zero-based index in the source data.

• data — Complete source data array.

Returns

Paint and radius overrides for this point. See PointMarkStyle.

See also

PointMarkStyle

PointSeriesProps

View source — packages/core/src/features/viz/lib/point-types.ts:61

PointSeriesProps

Authored inputs for PointSeries, including the declared data and presentation options.

interface PointSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions

Related API: PointSeriesProps, PibblEventHandlers, PibblEventParticipationOptions.

See also

PibblEventHandlers

PibblEventParticipationOptions

SignalValue

PointAccessor

ScaleId

SignalStyle

PointSeriesStyle

PointStyleResolver

View source — packages/core/src/features/viz/lib/point-types.ts:78

Properties and methods

data

readonly data: SignalValue<readonly D[]>

Related API: SignalValue.

Application data supplied to the component or reported by the event. See SignalValue.

View source — packages/core/src/features/viz/lib/point-types.ts:83

x

readonly x: SeriesAccessor<D>

Related API: SeriesAccessor.

Property key or callback extracting the horizontal domain coordinate. See PointAccessor.

View source — packages/core/src/features/viz/lib/point-types.ts:85

y

readonly y: SeriesAccessor<D>

Related API: SeriesAccessor.

Property key or callback extracting the vertical domain coordinate. See PointAccessor.

View source — packages/core/src/features/viz/lib/point-types.ts:87

xScale

readonly xScale: ScaleId

Related API: ScaleId.

The scale used to map horizontal data coordinates. See ScaleId.

View source — packages/core/src/features/viz/lib/point-types.ts:89

yScale

readonly yScale: ScaleId

Related API: ScaleId.

The scale used to map vertical data coordinates. See ScaleId.

View source — packages/core/src/features/viz/lib/point-types.ts:91

defined (optional)

readonly defined?: ((datum: D, index: number, data: readonly D[]) => boolean) | undefined

Returns whether a datum contributes drawable or queryable coordinates. See PointSeriesProps.

Parameters

• datum — Datum to test.

• index — Zero-based index in the source data.

• data — Complete source data array.

Returns

Whether this datum should participate in the series or query.

View source — packages/core/src/features/viz/lib/point-types.ts:100

style (optional)

readonly style?: SignalValue<PointStyleResolver<D> | Readonly<{ readonly radius?: SignalValue<number | undefined>; readonly fill?: SignalValue<FillStyle | undefined>; readonly stroke?: SignalValue<StrokeStyle | undefined>; readonly strokeWidth?: SignalValue<number | undefined>; readonly opacity?: SignalValue<number | undefined>; readonly cursor?: SignalValue<string | undefined>; }>> | undefined

Related API: SignalValue, PointStyleResolver, FillStyle, StrokeStyle, opacity.

Declared presentation and layout properties. See SignalValue, SignalStyle, PointSeriesStyle, PointStyleResolver.

View source — packages/core/src/features/viz/lib/point-types.ts:105

pointerEvents (optional)

readonly pointerEvents?: PibblPointerEvents | undefined

Related API: PibblPointerEvents.

Whether this content participates in pointer targeting. See PibblPointerEvents.

View source — packages/core/src/lib/events/types.ts:126

Implementation guidance for agents

Read the Data visualization companion for ownership, adaptation, failure modes, and verification. Agent start provides the version-selection workflow.

Complete minimal examples

• Point and custom plot series: Render styled point marks and custom keyed point content. Plain source

Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.