@fundar/data-chart-telling 0.0.14 → 0.0.16

package/dist/plots/line/Plot.svelte

@@ -8,13 +8,32 @@
   import { getConfiguration } from '../../configuration/config.svelte';
   import { paletteColor } from '../../utils/color';
   import { buildSeries } from '../../utils/grouping';
-  import PlotLayout from '../../layout/plot/PlotLayout.svelte';
-  import HoverMarker from '../markers/HoverMarker.svelte';
+  import { getLegendInteraction } from '../../layout/legend/interaction.svelte';
+  import { disabledStrokeOverride, disabledDotsOverride } from '../utils/legendDisabled';
+  import BasePlotLayout from '../../layout/plot/BasePlotLayout.svelte';
+  import AxisLayout from '../../layout/plot/AxisLayout.svelte';
+  import GridLayout from '../../layout/plot/GridLayout.svelte';
+  import RuleLayout from '../../layout/plot/RuleLayout.svelte';
+  import HoverMarker from '../../markers/HoverMarker.svelte';
+  import { hasHoverMarker, resolveHoverStrategy, resolveHoverSync } from '../../layout/tooltip/utils';
   import { buildGroupedSeries, validateSegments, resolveSegmentsForSeries, matchesSegmentX, getDataForSegments } from '../utils/segments';
-  import type { PlotProps } from '../../types/plots/props';
-  import type { Series, AxisValue } from '../../types/plots/common';
-  import type { LineSegmentStyle, ValueAnchor } from '../../types/plots/styles';
-  import type { Marker } from '../../types/plots/markers';
+  import type { BasePlotProps } from '../../types/plots/props';
+  import type { AxisValue } from '../../types/plots/axis';
+  import type { Series, SeriesProps, DataProps } from '../../types/plots/data/common';
+  import type { AxisBasedScalesConfig } from '../../types/plots/props';
+  import type { BasePlotStyles } from '../../types/plots/styles/common';
+  import type { ValueAnchor } from '../../types/plots/constants';
+  import type { LineSegmentStyle } from '../../types/plots/segments/common';
+  import type { Marker } from '../../types/markers/common';
+
+  type Props = BasePlotProps<
+    SeriesProps<TData> | DataProps<TData>,
+    TData,
+    BasePlotStyles,
+    LineSegmentStyle,
+    Marker,
+    AxisBasedScalesConfig<TData>
+  >;
 
   let {
     width,
@@ -30,9 +49,10 @@
     scales = {},
     margins,
     tooltip = undefined,
-  }: PlotProps<TData, LineSegmentStyle> = $props();
+  }: Props = $props();
 
   const resolvedSeries = $derived(series ?? buildSeries(data!, x!, y!, z));
+  const legendInteraction = $derived(getLegendInteraction());
 
   $effect(() => { validateSegments(segments); });
 
@@ -57,12 +77,19 @@
     styles.values?.format ?? ((v: number, name: string) => `${name} - ${v}`),
   );
   const valAnchor = $derived<ValueAnchor>(styles.values?.anchor ?? 'start');
+  // 'outside' is a per-point escape hatch resolved by HoverMarker; line's own
+  // value labels already have their own `anchor: 'outside'` concept above,
+  // so treat it as unset here.
+  const resolvedTextAnchor = $derived(styles.values?.textAnchor === 'outside' ? undefined : styles.values?.textAnchor);
 
   const xAcc = $derived(resolveAccessor(resolvedSeries[0]?.x ?? ((d: TData) => d)));
   const yAcc = $derived(resolveAccessor(resolvedSeries[0]?.y ?? ((d: TData) => d)));
   const flat = $derived(resolvedSeries.flatMap((s) => s.data));
+  // A legend-disabled series is dimmed on the mark itself, but never surfaces
+  // in hover/tooltip — its points are simply absent from the candidate list.
   const hoverPoints = $derived(
     resolvedSeries.flatMap((s, idx) => {
+      if (legendInteraction?.disabledSeries.has(s.name)) return [];
       const sx = resolveAccessor(s.x);
       const sy = resolveAccessor(s.y);
       return s.data.map((d) => ({
@@ -82,28 +109,37 @@
       .map((s, idx) => ({ series: s, lastRow: s.data[s.data.length - 1], seriesIndex: idx }))
       .filter(({ lastRow }) => lastRow !== undefined),
   );
+
+  const hoverActive = $derived(tooltip != null || hasHoverMarker(markers));
+  const hoverStrategy = $derived(resolveHoverStrategy(tooltip?.strategy, markers, 'x'));
+  const hoverSync = $derived(resolveHoverSync(tooltip?.sync, markers));
 </script>
 
-<PlotLayout
+<BasePlotLayout
   {width}
   {height}
-  x={scales.x}
-  y={scales.y}
   data={flat}
   getX={xAcc}
   getY={(d) => Number(yAcc(d))}
   {hoverPoints}
   label={(r) => String(yAcc(r))}
   {tooltip}
-  {markers}
-  seriesData={resolvedSeries}
+  {hoverActive}
+  {hoverStrategy}
+  {hoverSync}
   {scales}
   {margins}
-  defaultStrategy="x"
+  xTickRotate={scales?.x?.tickRotate}
 >
-  {#snippet children({ matchedPoints, ruleX, ruleY, impliesRuleX, impliesRuleY })}
+  {#snippet children({ matchedPoints, ruleX, ruleY, impliesRuleX, impliesRuleY, numericMargins })}
+  <AxisLayout data={flat} getX={xAcc} getY={(d) => Number(yAcc(d))} {width} {height} {numericMargins} {scales} />
+  <GridLayout {scales} />
+  <RuleLayout {markers} seriesData={resolvedSeries} {matchedPoints} {ruleX} {ruleY} {impliesRuleX} {impliesRuleY}>
   {#each groupedSeries as group, seriesIndex (group.series.name)}
     {@const defaultColor = paletteColor(seriesIndex, cfg.palette)}
+    {@const disabledOverride = legendInteraction?.disabledSeries.get(group.series.name)}
+    {@const disabledStroke = disabledStrokeOverride(disabledOverride)}
+    {@const disabledDots = disabledDotsOverride(disabledOverride)}
     {#each group.visualSegments as seg, i (`${group.series.name}-${i}`)}
       {@const strokeStyle = seg.style.stroke}
       {@const lineData = seg.data as unknown as Record<string | symbol, never>[]}
@@ -111,12 +147,12 @@
         data={lineData}
         x={resolveAccessor(group.series.x)}
         y={resolveAccessor(group.series.y)}
-        stroke={strokeStyle?.stroke ?? defaultColor}
-        strokeWidth={strokeStyle?.strokeWidth ?? cfg.line.strokeWidth}
-        strokeOpacity={strokeStyle?.strokeOpacity ?? 1}
-        strokeDasharray={strokeStyle?.strokeDasharray}
-        strokeLinejoin={strokeStyle?.strokeLinejoin}
-        strokeLinecap={strokeStyle?.strokeLinecap}
+        stroke={disabledStroke?.stroke ?? strokeStyle?.stroke ?? defaultColor}
+        strokeWidth={disabledStroke?.strokeWidth ?? strokeStyle?.strokeWidth ?? cfg.line.strokeWidth}
+        strokeOpacity={disabledStroke?.strokeOpacity ?? strokeStyle?.strokeOpacity ?? 1}
+        strokeDasharray={disabledStroke?.strokeDasharray ?? strokeStyle?.strokeDasharray}
+        strokeLinejoin={disabledStroke?.strokeLinejoin ?? strokeStyle?.strokeLinejoin}
+        strokeLinecap={disabledStroke?.strokeLinecap ?? strokeStyle?.strokeLinecap}
       />
       {#if seg.style.dots}
         {@const dotStyle = seg.style.dots}
@@ -124,14 +160,14 @@
           data={seg.data}
           x={resolveAccessor(group.series.x)}
           y={resolveAccessor(group.series.y)}
-          r={dotStyle.dotRadius ?? cfg.line.dotRadius}
-          fill={dotStyle.dotFill ?? strokeStyle?.stroke ?? defaultColor}
-          symbol={dotStyle.dotSymbol ?? 'circle'}
-          stroke={dotStyle.dotStroke ?? strokeStyle?.stroke ?? defaultColor}
-          strokeWidth={dotStyle.dotStrokeWidth ?? 1}
-          fillOpacity={dotStyle.dotFillOpacity ?? strokeStyle?.strokeOpacity ?? 1}
-          strokeOpacity={dotStyle.dotStrokeOpacity ?? strokeStyle?.strokeOpacity ?? 1}
-          strokeDasharray={dotStyle.dotStrokeDasharray}
+          r={disabledDots?.dotRadius ?? dotStyle.dotRadius ?? cfg.line.dotRadius}
+          fill={disabledDots?.dotFill ?? dotStyle.dotFill ?? strokeStyle?.stroke ?? defaultColor}
+          symbol={disabledDots?.dotSymbol ?? dotStyle.dotSymbol ?? 'circle'}
+          stroke={disabledDots?.dotStroke ?? dotStyle.dotStroke ?? strokeStyle?.stroke ?? defaultColor}
+          strokeWidth={disabledDots?.dotStrokeWidth ?? dotStyle.dotStrokeWidth ?? 1}
+          fillOpacity={disabledDots?.dotFillOpacity ?? dotStyle.dotFillOpacity ?? strokeStyle?.strokeOpacity ?? 1}
+          strokeOpacity={disabledDots?.dotStrokeOpacity ?? dotStyle.dotStrokeOpacity ?? strokeStyle?.strokeOpacity ?? 1}
+          strokeDasharray={disabledDots?.dotStrokeDasharray ?? dotStyle.dotStrokeDasharray}
         />
       {/if}
     {/each}
@@ -221,7 +257,7 @@
         text={() => fmtVal(Number(yFn(lastRow)), s.name)}
         dx={styles.values?.dx ?? defaultDx}
         dy={styles.values?.dy ?? defaultDy}
-        textAnchor={styles.values?.textAnchor ?? defaultTA}
+        textAnchor={resolvedTextAnchor ?? defaultTA}
         lineAnchor={styles.values?.lineAnchor ?? defaultLA}
         lineHeight={styles.values?.lineHeight}
         rotate={styles.values?.rotate}
@@ -232,5 +268,6 @@
       />
     {/each}
   {/if}
+  </RuleLayout>
   {/snippet}
-</PlotLayout>
+</BasePlotLayout>

package/dist/plots/line/Plot.svelte.d.ts

@@ -1,7 +1,11 @@
-import type { PlotProps } from '../../types/plots/props';
-import type { LineSegmentStyle } from '../../types/plots/styles';
+import type { BasePlotProps } from '../../types/plots/props';
+import type { SeriesProps, DataProps } from '../../types/plots/data/common';
+import type { AxisBasedScalesConfig } from '../../types/plots/props';
+import type { BasePlotStyles } from '../../types/plots/styles/common';
+import type { LineSegmentStyle } from '../../types/plots/segments/common';
+import type { Marker } from '../../types/markers/common';
 declare function $$render<TData extends Record<string, unknown>>(): {
-    props: PlotProps<TData, LineSegmentStyle>;
+    props: BasePlotProps<SeriesProps<TData> | DataProps<TData>, TData, BasePlotStyles, LineSegmentStyle, Marker, AxisBasedScalesConfig<TData>>;
     exports: {};
     bindings: "";
     slots: {};

package/dist/plots/pyramid/Plot.svelte

@@ -5,13 +5,23 @@
   import { getConfiguration } from '../../configuration/config.svelte';
   import { paletteColor } from '../../utils/color';
   import { buildSeries } from '../../utils/grouping';
+  import { getLegendInteraction } from '../../layout/legend/interaction.svelte';
+  import { disabledFillOverride } from '../utils/legendDisabled';
   import { buildGroupedSeries, validateSegments, resolveSegmentsForSeries, matchesSegmentX, getDataForSegments } from '../utils/segments';
-  import PlotLayout from '../../layout/plot/PlotLayout.svelte';
-  import HoverMarker from '../markers/HoverMarker.svelte';
-  import type { PlotProps } from '../../types/plots/props';
-  import type { Series, AxisValue } from '../../types/plots/common';
-  import type { BarSegmentStyle, ValueAnchor } from '../../types/plots/styles';
-  import type { Marker } from '../../types/plots/markers';
+  import BasePlotLayout from '../../layout/plot/BasePlotLayout.svelte';
+  import AxisLayout from '../../layout/plot/AxisLayout.svelte';
+  import GridLayout from '../../layout/plot/GridLayout.svelte';
+  import RuleLayout from '../../layout/plot/RuleLayout.svelte';
+  import HoverMarker from '../../markers/HoverMarker.svelte';
+  import { hasHoverMarker, resolveHoverStrategy, resolveHoverSync } from '../../layout/tooltip/utils';
+  import type { BasePlotProps } from '../../types/plots/props';
+  import type { AxisValue } from '../../types/plots/axis';
+  import type { Series, SeriesProps, DataProps } from '../../types/plots/data/common';
+  import type { AxisBasedScalesConfig } from '../../types/plots/props';
+  import type { BasePlotStyles } from '../../types/plots/styles/common';
+  import type { ValueAnchor } from '../../types/plots/constants';
+  import type { BarSegmentStyle } from '../../types/plots/segments/common';
+  import type { Marker } from '../../types/markers/common';
 
   /**
    * A population-pyramid-style diverging bar chart: each series is mirrored
@@ -29,6 +39,15 @@
   type PyramidSide = 'left' | 'right';
   type InternalSeries = Series<TData> & { side: PyramidSide };
 
+  type Props = BasePlotProps<
+    SeriesProps<TData> | DataProps<TData>,
+    TData,
+    BasePlotStyles,
+    BarSegmentStyle,
+    Marker,
+    AxisBasedScalesConfig<TData>
+  >;
+
   let {
     width,
     height,
@@ -43,16 +62,21 @@
     segments = {},
     markers = [],
     tooltip = undefined,
-  }: PlotProps<TData, BarSegmentStyle> = $props();
+  }: Props = $props();
 
   $effect(() => { validateSegments(segments); });
 
   const cfg = $derived(getConfiguration());
+  const legendInteraction = $derived(getLegendInteraction());
   const leftColor = $derived(styles.colors?.left ?? paletteColor(0, cfg.palette));
   const rightColor = $derived(styles.colors?.right ?? paletteColor(1, cfg.palette));
   const showVals = $derived(styles.values?.show ?? false);
   const fmtVal = $derived(styles.values?.format ?? ((v: number) => `${v}`));
   const valAnchor = $derived<ValueAnchor>(styles.values?.anchor ?? 'outside');
+  // 'outside' is a per-point escape hatch resolved by HoverMarker; pyramid's
+  // own value labels already have their own `anchor: 'outside'` concept
+  // above, so treat it as unset here.
+  const resolvedTextAnchor = $derived(styles.values?.textAnchor === 'outside' ? undefined : styles.values?.textAnchor);
 
   // Sort series names alphabetically; even index → left, odd → right.
   // scales.z.reverse flips the assignment so the second name goes left.
@@ -68,7 +92,9 @@
   });
 
   const groupedSeries = $derived(
-    buildGroupedSeries<InternalSeries, BarSegmentStyle>(resolvedSeries, segments),
+    // connect: false — bars are discrete; there's no visual gap between
+    // adjacent categories to bridge (see buildGroupedSeries's own doc).
+    buildGroupedSeries<InternalSeries, BarSegmentStyle>(resolvedSeries, segments, false),
   );
 
   function signedValue(s: InternalSeries, d: TData): number {
@@ -111,15 +137,19 @@
   const getY = (d: TaggedRow) => d.__y;
   const labelFor = (d: TaggedRow) => d.__label;
 
+  // A legend-disabled series is dimmed on the bar itself, but never surfaces
+  // in hover/tooltip — its points are simply absent from the candidate list.
   const hoverPoints = $derived(
-    flat.map((d) => ({
-      x: d.__x,
-      y: d.__y,
-      row: d,
-      label: d.__label,
-      series: d.__series,
-      color: d.__side === 'left' ? leftColor : rightColor,
-    })),
+    flat
+      .filter((d) => !legendInteraction?.disabledSeries.has(d.__series))
+      .map((d) => ({
+        x: d.__x,
+        y: d.__y,
+        row: d,
+        label: d.__label,
+        series: d.__series,
+        color: d.__side === 'left' ? leftColor : rightColor,
+      })),
   );
 
   const yDomain = $derived([
@@ -149,42 +179,59 @@
     }
     return map;
   });
+
+  // The single, fully-resolved scales object BasePlotLayout reads for
+  // everything (ticks, grid, sort, and the real svelteplot scale) — avoids
+  // keeping a second, separately-defaulted copy of `scales.x`/`scales.y`
+  // (our own diverging-domain + band-scale defaults) out of sync with the
+  // one actually forwarded.
+  const resolvedScales = $derived<AxisBasedScalesConfig<TData>>({
+    ...scales,
+    x: {
+      domain: [-maxMagnitude, maxMagnitude],
+      tickFormat: (v: unknown) => fmtVal(Math.abs(Number(v)), ''),
+      ...(scales.x ?? {}),
+    },
+    y: { type: 'band', padding: 0.2, domain: yDomain, ...(scales.y ?? {}) },
+  });
+
+  const hoverActive = $derived(tooltip != null || hasHoverMarker(markers));
+  const hoverStrategy = $derived(resolveHoverStrategy(tooltip?.strategy, markers, 'y'));
+  const hoverSync = $derived(resolveHoverSync(tooltip?.sync, markers));
 </script>
 
-<PlotLayout
+<BasePlotLayout
   {width}
   {height}
-  x={{
-    domain: [-maxMagnitude, maxMagnitude],
-    tickFormat: (v: unknown) => fmtVal(Math.abs(Number(v)), ''),
-    ...(scales.x ?? {}),
-  }}
-  y={{ type: 'band', padding: 0.2, domain: yDomain, ...(scales.y ?? {}) }}
   data={flat}
   {getX}
   {getY}
-  matchY={getY}
   {hoverPoints}
   label={labelFor}
   {tooltip}
-  {markers}
-  seriesData={resolvedSeries}
-  {scales}
+  {hoverActive}
+  {hoverStrategy}
+  {hoverSync}
+  scales={resolvedScales}
   {margins}
-  defaultStrategy="y"
+  xTickRotate={resolvedScales?.x?.tickRotate}
 >
-  {#snippet children({ matchedPoints, ruleX, ruleY, impliesRuleX, impliesRuleY })}
+  {#snippet children({ matchedPoints, ruleX, ruleY, impliesRuleX, impliesRuleY, numericMargins })}
+  <AxisLayout data={flat} {getX} {getY} {width} {height} {numericMargins} scales={resolvedScales} />
+  <GridLayout scales={resolvedScales} />
+  <RuleLayout {markers} seriesData={resolvedSeries} {matchedPoints} {ruleX} {ruleY} {impliesRuleX} {impliesRuleY}>
     {#each groupedSeries as group (group.series.name)}
       {@const defaultColor = group.series.side === 'left' ? leftColor : rightColor}
       {@const getCategory = resolveAccessor(group.series.x)}
+      {@const disabledFill = disabledFillOverride(legendInteraction?.disabledSeries.get(group.series.name))}
       {#each group.visualSegments as seg, i (`${group.series.name}-${i}`)}
         <BarX
           data={seg.data}
           x1={0}
           x2={(d: TData) => signedValue(group.series, d)}
           y={getCategory}
-          fill={seg.style.fill ?? defaultColor}
-          fillOpacity={seg.style.fillOpacity ?? 1}
+          fill={disabledFill?.fill ?? seg.style.fill ?? defaultColor}
+          fillOpacity={disabledFill?.fillOpacity ?? seg.style.fillOpacity ?? 1}
         />
       {/each}
 
@@ -210,14 +257,19 @@
           text={(d: TData) => fmtVal(Math.abs(Number(resolveAccessor(group.series.y)(d))), group.series.name)}
           dx={styles.values?.dx ?? defaultDx}
           dy={styles.values?.dy ?? 0}
-          textAnchor={styles.values?.textAnchor ?? defaultTextAnchor}
+          textAnchor={resolvedTextAnchor ?? defaultTextAnchor}
           lineAnchor={styles.values?.lineAnchor ?? 'middle'}
           lineHeight={styles.values?.lineHeight}
           rotate={styles.values?.rotate}
           class={styles.values?.class}
           textClass={styles.values?.textClass}
-          fill={cfg.axis.color}
-          fontSize={12}
+          fill={styles.values?.fill ?? cfg.axis.color}
+          fontSize={styles.values?.fontSize ?? 12}
+          fontWeight={styles.values?.fontWeight}
+          fontStyle={styles.values?.fontStyle}
+          stroke={styles.values?.stroke}
+          strokeWidth={styles.values?.strokeWidth}
+          paintOrder={styles.values?.paintOrder}
         />
       {/if}
 
@@ -282,5 +334,6 @@
         {/if}
       {/each}
     {/each}
+  </RuleLayout>
   {/snippet}
-</PlotLayout>
+</BasePlotLayout>

package/dist/plots/pyramid/Plot.svelte.d.ts

@@ -1,7 +1,11 @@
-import type { PlotProps } from '../../types/plots/props';
-import type { BarSegmentStyle } from '../../types/plots/styles';
+import type { BasePlotProps } from '../../types/plots/props';
+import type { SeriesProps, DataProps } from '../../types/plots/data/common';
+import type { AxisBasedScalesConfig } from '../../types/plots/props';
+import type { BasePlotStyles } from '../../types/plots/styles/common';
+import type { BarSegmentStyle } from '../../types/plots/segments/common';
+import type { Marker } from '../../types/markers/common';
 declare function $$render<TData extends Record<string, unknown>>(): {
-    props: PlotProps<TData, BarSegmentStyle>;
+    props: BasePlotProps<SeriesProps<TData> | DataProps<TData>, TData, BasePlotStyles, BarSegmentStyle, Marker, AxisBasedScalesConfig<TData>>;
     exports: {};
     bindings: "";
     slots: {};

package/dist/plots/utils/delta.d.ts

@@ -1,4 +1,4 @@
-import type { Series } from '../../types/plots/common';
+import type { Series } from '../../types/plots/data/common';
 import type { DeltaConfig } from '../../types/plots/delta';
 export type ResolvedDelta = {
     cfg: DeltaConfig;

package/dist/plots/utils/geoAccessors.d.ts

@@ -0,0 +1,64 @@
+import type { GeoFeature } from '../../types/plots/data/geo';
+/**
+ * Bounding-box center of a geometry's flattened coordinates — a cheap
+ * approximation used for default label placement, not a true
+ * geographic/area centroid (no polygon-hole or geodesic-area weighting).
+ * For hover-matching specifically, see `geometryPartCentroids` instead —
+ * this single combined point can land far from every actual part of a
+ * multi-part geometry whose pieces are geographically spread out.
+ */
+export declare function geometryCentroid(geometry: GeoJSON.Geometry): [number, number];
+/**
+ * Splits a geometry into its disjoint parts: one `Polygon` per element of a
+ * `MultiPolygon`'s `coordinates`, one `LineString` per element of a
+ * `MultiLineString`'s, `GeometryCollection` recursed and flattened, and any
+ * other geometry type returned unchanged as its own single-element array.
+ * The shared building block behind `geometryPartCentroids` (one centroid per
+ * part) and `filterGeometryParts` (keep/drop whole parts).
+ */
+export declare function splitGeometryParts(geometry: GeoJSON.Geometry): GeoJSON.Geometry[];
+/**
+ * Like `geometryCentroid`, but returns one point per disjoint part instead
+ * of a single bounding-box center across all of them. A `MultiPolygon`
+ * whose parts are geographically far apart — e.g. Argentina's "Tierra del
+ * Fuego, Antártida e Islas del Atlántico Sur" province, whose `MultiPolygon`
+ * spans the mainland island, the Antarctic sector, and the South Atlantic
+ * islands in one feature — would otherwise get a single hover point
+ * stranded somewhere between all of them, matching hovers over *none* of
+ * the actually-rendered shapes. Multiple points attributed to the same
+ * feature is fine for hover-matching (nearest point wins, whichever part
+ * that is); it's only label placement (`geometryCentroid`) that needs a
+ * single point.
+ */
+export declare function geometryPartCentroids(geometry: GeoJSON.Geometry): [number, number][];
+/**
+ * Keeps or drops each disjoint part of a geometry (see `splitGeometryParts`)
+ * based on a per-part predicate, reassembling a geometry of the same type
+ * from whatever survives — `null` if nothing does. Used to let a single
+ * feature's geometry be split between the main map and an `inset` marker
+ * (see `GeoDataProps.excludeParts`/`GeoInsetMarker.featurePartsFilter`)
+ * without preprocessing the source data: e.g. a province whose `MultiPolygon`
+ * spans both a mainland part and a far-flung part can have the main map
+ * exclude the latter while an inset shows only it.
+ */
+export declare function filterGeometryParts(geometry: GeoJSON.Geometry, keep: (part: {
+    centroid: [number, number];
+    geometry: GeoJSON.Geometry;
+}) => boolean): GeoJSON.Geometry | null;
+/** Default `featureId`: `feature.id`, else `properties.id`, else `properties.name`. */
+export declare function defaultFeatureId<TProps extends Record<string, unknown>>(f: GeoFeature<TProps>): string;
+/**
+ * Densifies a great-circle arc between two lon/lat points into `steps + 1`
+ * points via spherical linear interpolation (slerp) — used to draw a `link`
+ * marker's geodesic curve through the `Geo` mark (see `Plot.svelte`).
+ *
+ * Not delegated to svelteplot's own `Link` mark: its 0.14.2 projection
+ * integration (`Mark.svelte`'s paired-channel handling) reads a single
+ * `row.x`/`row.y` pair regardless of channel suffix, so a mark bound to
+ * `x1`/`y1`/`x2`/`y2` (never plain `x`/`y`) resolves every point as invalid
+ * whenever the plot has an active `projection` scale — which GeoPlot always
+ * does. `Geo` has no such limitation (geo marks are explicitly excluded from
+ * that code path), so a manually-interpolated `LineString` feature sidesteps
+ * the bug entirely while still producing the same geodesic visual.
+ */
+export declare function greatCircleInterpolate(lon1: number, lat1: number, lon2: number, lat2: number, steps?: number): [number, number][];