@fundar/data-chart-telling 0.0.64 → 1.1.0

package/dist/charts/line/Chart.svelte

@@ -1,112 +0,0 @@
-<script lang="ts" generics="TRow extends Record<string, unknown>">
-  import BaseChart from '../BaseChart.svelte';
-  import LinePlot from '../../plots/line/Plot.svelte';
-  import {
-    resolveTooltip,
-    resolveHoverStrategy,
-    resolveHoverSync,
-    hasHoverMarker
-  } from '../../layout/tooltip/utils';
-  import { resolveAccessor } from '../../plots/utils/accessors';
-  import { resolveTimelineInterpolation } from '../../utils/interpolate';
-  import type { LineSegmentStyle } from '../../types/plots/segments/common';
-  import type { GapsAwareChartProps } from '../../types/charts/props';
-
-  /**
-   * High-level line chart. It takes flat rows plus `x`/`y`/`z` encodings, groups
-   * by `z` into one line per group, and hands the result to {@link LinePlot}.
-   * Everything chrome-related (title, legend, timeline, facets) is delegated to
-   * {@link BaseChart}; this component only owns the flat-data → line-series adaption.
-   */
-  let {
-    width,
-    height,
-    title,
-    subtitle,
-    caption,
-    legend,
-    header,
-    footer,
-    data,
-    x,
-    y,
-    z,
-    styles = {},
-    segments,
-    markers = [],
-    scales = {},
-    margins,
-    facet,
-    timeline,
-    tooltip,
-  }: GapsAwareChartProps<TRow, LineSegmentStyle> = $props();
-
-  // A line should grow into its full extent over time, not snap to a single
-  // year's point — so default to a cumulative reveal unless the caller wants
-  // the bar/heatmap-style exact-step snapshot instead.
-  const timelineConfig = $derived(
-    timeline
-      ? {
-          ...timeline,
-          filterMode: timeline.filterMode ?? 'upTo',
-          interpolate: resolveTimelineInterpolation(timeline.interpolate, { value: y, key: z }),
-        }
-      : undefined,
-  );
-
-  const tip = $derived(resolveTooltip(tooltip, 'x'));
-  const hoverEnabled = $derived(tip.enabled || hasHoverMarker(markers));
-  const resolvedStrategy = $derived(resolveHoverStrategy(tip.enabled ? tip.strategy : undefined, markers, 'x'));
-  const resolvedSync = $derived(resolveHoverSync(tip.enabled ? tip.sync : undefined, markers));
-  const getX = $derived(resolveAccessor<TRow>(x));
-  const getY = $derived(resolveAccessor<TRow>(y));
-  const getZ = $derived(z ? resolveAccessor<TRow>(z) : null);
-  const fmtX = (v: unknown) => (v instanceof Date ? v.toLocaleDateString() : String(v));
-  const defaultFormat = $derived((row: TRow) => {
-    const group = getZ ? `${getZ(row)}\n` : '';
-    return `${group}${fmtX(getX(row))}: ${getY(row)}`;
-  });
-</script>
-
-<BaseChart
-  {width}
-  {height}
-  {title}
-  {subtitle}
-  {caption}
-  {legend}
-  {header}
-  {footer}
-  {data}
-  {facet}
-  timeline={timelineConfig}
-  hover={hoverEnabled ? { strategy: resolvedStrategy, sync: resolvedSync } : undefined}
->
-  {#snippet plot({ data: rows, width: w, height: h, facetValue })}
-    <LinePlot
-      width={w}
-      height={h}
-      data={rows}
-      {x}
-      {y}
-      {z}
-      {styles}
-      {segments}
-      {markers}
-      {scales}
-      {margins}
-      tooltip={tip.enabled
-        ? {
-            format: tip.format ?? defaultFormat,
-            facetId: facetValue ?? '',
-            strategy: tip.strategy,
-            sync: tip.sync,
-            series: tip.series,
-            content: tip.content,
-            anchorX: tip.anchorX,
-            anchorY: tip.anchorY,
-          }
-        : undefined}
-    />
-  {/snippet}
-</BaseChart>

package/dist/charts/line/Chart.svelte.d.ts

@@ -1,26 +0,0 @@
-import type { LineSegmentStyle } from '../../types/plots/segments/common';
-import type { GapsAwareChartProps } from '../../types/charts/props';
-declare function $$render<TRow extends Record<string, unknown>>(): {
-    props: GapsAwareChartProps<TRow, LineSegmentStyle>;
-    exports: {};
-    bindings: "";
-    slots: {};
-    events: {};
-};
-declare class __sveltets_Render<TRow extends Record<string, unknown>> {
-    props(): ReturnType<typeof $$render<TRow>>['props'];
-    events(): ReturnType<typeof $$render<TRow>>['events'];
-    slots(): ReturnType<typeof $$render<TRow>>['slots'];
-    bindings(): "";
-    exports(): {};
-}
-interface $$IsomorphicComponent {
-    new <TRow extends Record<string, unknown>>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TRow>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TRow>['props']>, ReturnType<__sveltets_Render<TRow>['events']>, ReturnType<__sveltets_Render<TRow>['slots']>> & {
-        $$bindings?: ReturnType<__sveltets_Render<TRow>['bindings']>;
-    } & ReturnType<__sveltets_Render<TRow>['exports']>;
-    <TRow extends Record<string, unknown>>(internal: unknown, props: ReturnType<__sveltets_Render<TRow>['props']> & {}): ReturnType<__sveltets_Render<TRow>['exports']>;
-    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
-}
-declare const Chart: $$IsomorphicComponent;
-type Chart<TRow extends Record<string, unknown>> = InstanceType<typeof Chart<TRow>>;
-export default Chart;

package/dist/charts/pyramid/Chart.svelte

@@ -1,134 +0,0 @@
-<script lang="ts" generics="TRow extends Record<string, unknown>">
-  import BaseChart from '../BaseChart.svelte';
-  import PyramidPlot from '../../plots/pyramid/Plot.svelte';
-  import {
-    resolveTooltip,
-    resolveHoverStrategy,
-    resolveHoverSync,
-    hasHoverMarker
-  } from '../../layout/tooltip/utils';
-  import { resolveAccessor } from '../../plots/utils/accessors';
-  import { resolveTimelineInterpolation } from '../../utils/interpolate';
-  import type { AxisValue } from '../../types/layout/scales';
-  import type { Accessor } from '../../types/plots/data/common';
-  import type { BarSegmentStyle } from '../../types/plots/segments/common';
-  import type { GapsAwareChartProps } from '../../types/charts/props';
-
-  /**
-   * High-level population-pyramid-style chart. Forwards flat rows and the
-   * `x`/`y`/`z` accessors straight to {@link PyramidPlot}, which groups them
-   * into series and assigns left/right sides automatically from the
-   * alphabetical order of `z` values. Pass `scales.z.reverse: true` to flip
-   * which side goes first. Delegates all chrome (title, legend, timeline,
-   * facets) to {@link BaseChart}.
-   */
-  let {
-    width,
-    height,
-    title,
-    subtitle,
-    caption,
-    legend,
-    header,
-    footer,
-    data,
-    x: magnitude,
-    y: category,
-    z: sides,
-    styles = {},
-    scales = {},
-    margins,
-    segments,
-    markers = [],
-    facet,
-    timeline,
-    tooltip,
-  }: GapsAwareChartProps<TRow, BarSegmentStyle> & { x: Accessor<TRow, number>; z: Accessor<TRow, unknown> } = $props();
-
-  const getMagnitude = $derived(resolveAccessor<TRow>(magnitude));
-  const getCategory = $derived(resolveAccessor<TRow>(category));
-  const getSides = $derived(resolveAccessor<TRow>(sides));
-  const formatValue = $derived(styles.values?.format ?? ((v: number) => `${v}`));
-
-  // Computed once over the full dataset (not the per-facet/timeline-filtered
-  // rows) so the diverging axis and category bands stay comparable across
-  // timeline steps/facets — the same reasoning HeatmapChart applies to its
-  // colour domain.
-  const categoryDomain = $derived([...new Set(data.map((d) => getCategory(d) as AxisValue))]);
-  const maxMagnitude = $derived.by(() => {
-    const vals = data.map((d) => Math.abs(Number(getMagnitude(d))));
-    return vals.length ? Math.max(...vals) : 1;
-  });
-  // Spread all caller scales first so scales.z (used by PyramidPlot for side
-  // assignment) is preserved, then override x/y with the computed domains.
-  const resolvedScales = $derived({
-    ...scales,
-    x: { domain: [-maxMagnitude, maxMagnitude], ...(scales.x ?? {}) },
-    y: { domain: categoryDomain, ...(scales.y ?? {}) },
-  });
-  // A pyramid timeline snapshots one frame per step; interpolation needs to
-  // match each bar across steps by its category and z-group, not by the
-  // timeline's own time field.
-  const timelineConfig = $derived(
-    timeline
-      ? {
-          ...timeline,
-          interpolate: resolveTimelineInterpolation(timeline.interpolate, {
-            value: magnitude,
-            key: (d: TRow) => `${String(getCategory(d))}::${String(getSides(d))}`,
-          }),
-        }
-      : undefined,
-  );
-
-  const tip = $derived(resolveTooltip(tooltip, 'y'));
-  const hoverEnabled = $derived(tip.enabled || hasHoverMarker(markers));
-  const resolvedStrategy = $derived(resolveHoverStrategy(tip.enabled ? tip.strategy : undefined, markers, 'y'));
-  const resolvedSync = $derived(resolveHoverSync(tip.enabled ? tip.sync : undefined, markers));
-  const defaultFormat = $derived(
-    (row: TRow) => `${String(getSides(row))}\n${String(getCategory(row))}: ${formatValue(Number(getMagnitude(row)), String(getSides(row)))}`,
-  );
-</script>
-
-<BaseChart
-  {width}
-  {height}
-  {title}
-  {subtitle}
-  {caption}
-  {legend}
-  {header}
-  {footer}
-  {data}
-  {facet}
-  timeline={timelineConfig}
-  hover={hoverEnabled ? { strategy: resolvedStrategy, sync: resolvedSync } : undefined}
->
-  {#snippet plot({ data: rows, width: w, height: h, facetValue })}
-    <PyramidPlot
-      width={w}
-      height={h}
-      data={rows}
-      x={magnitude}
-      y={category}
-      z={sides}
-      {styles}
-      scales={resolvedScales}
-      {margins}
-      {segments}
-      {markers}
-      tooltip={tip.enabled
-        ? {
-            format: tip.format ?? defaultFormat,
-            facetId: facetValue ?? '',
-            strategy: tip.strategy,
-            sync: tip.sync,
-            series: tip.series,
-            content: tip.content,
-            anchorX: tip.anchorX,
-            anchorY: tip.anchorY,
-          }
-        : undefined}
-    />
-  {/snippet}
-</BaseChart>

package/dist/charts/pyramid/Chart.svelte.d.ts

@@ -1,30 +0,0 @@
-import type { Accessor } from '../../types/plots/data/common';
-declare function $$render<TRow extends Record<string, unknown>>(): {
-    props: Omit<import("../../types/charts/props").ChartProps<TRow, import("../..").AreaStyle>, "styles"> & {
-        styles?: import("../..").GapsAwarePlotStylesConfig<import("../..").AreaStyle> | undefined;
-    } & {
-        x: Accessor<TRow, number>;
-        z: Accessor<TRow, unknown>;
-    };
-    exports: {};
-    bindings: "";
-    slots: {};
-    events: {};
-};
-declare class __sveltets_Render<TRow extends Record<string, unknown>> {
-    props(): ReturnType<typeof $$render<TRow>>['props'];
-    events(): ReturnType<typeof $$render<TRow>>['events'];
-    slots(): ReturnType<typeof $$render<TRow>>['slots'];
-    bindings(): "";
-    exports(): {};
-}
-interface $$IsomorphicComponent {
-    new <TRow extends Record<string, unknown>>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TRow>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TRow>['props']>, ReturnType<__sveltets_Render<TRow>['events']>, ReturnType<__sveltets_Render<TRow>['slots']>> & {
-        $$bindings?: ReturnType<__sveltets_Render<TRow>['bindings']>;
-    } & ReturnType<__sveltets_Render<TRow>['exports']>;
-    <TRow extends Record<string, unknown>>(internal: unknown, props: ReturnType<__sveltets_Render<TRow>['props']> & {}): ReturnType<__sveltets_Render<TRow>['exports']>;
-    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
-}
-declare const Chart: $$IsomorphicComponent;
-type Chart<TRow extends Record<string, unknown>> = InstanceType<typeof Chart<TRow>>;
-export default Chart;

package/dist/charts/scatter/Chart.svelte

@@ -1,95 +0,0 @@
-<script lang="ts" generics="TRow extends Record<string, unknown>">
-  import BaseChart from '../BaseChart.svelte';
-  import ScatterPlot from '../../plots/scatter/Plot.svelte';
-  import {
-    resolveTooltip,
-    resolveHoverStrategy,
-    resolveHoverSync,
-    hasHoverMarker
-  } from '../../layout/tooltip/utils';
-  import { resolveAccessor } from '../../plots/utils/accessors';
-  import type { Accessor } from '../../types/plots/data/common';
-  import type { ScatterSegmentStyle } from '../../types/plots/segments/common';
-  import type { ChartProps } from '../../types/charts/props';
-
-  /**
-   * High-level scatter chart. Groups flat rows by `z` into one point cloud
-   * per group and delegates all chrome to {@link BaseChart}. `r` gives every
-   * point a per-row radius (bubble sizing), independent of `z` grouping.
-   */
-  let {
-    width,
-    height,
-    title,
-    subtitle,
-    caption,
-    legend,
-    header,
-    footer,
-    data,
-    x,
-    y,
-    z,
-    r,
-    styles = {},
-    segments,
-    markers = [],
-    scales = {},
-    margins,
-    facet,
-    timeline,
-    tooltip,
-  }: ChartProps<TRow, ScatterSegmentStyle> & { r?: Accessor<TRow, number> | number } = $props();
-
-  const tip = $derived(resolveTooltip(tooltip, 'punctual'));
-  const hoverEnabled = $derived(tip.enabled || hasHoverMarker(markers));
-  const resolvedStrategy = $derived(resolveHoverStrategy(tip.enabled ? tip.strategy : undefined, markers, 'punctual'));
-  const resolvedSync = $derived(resolveHoverSync(tip.enabled ? tip.sync : undefined, markers));
-  const getX = $derived(resolveAccessor<TRow>(x));
-  const getY = $derived(resolveAccessor<TRow>(y));
-  const defaultFormat = $derived((row: TRow) => `${String(getX(row))}, ${String(getY(row))}`);
-</script>
-
-<BaseChart
-  {width}
-  {height}
-  {title}
-  {subtitle}
-  {caption}
-  {legend}
-  {header}
-  {footer}
-  {data}
-  {facet}
-  {timeline}
-  hover={hoverEnabled ? { strategy: resolvedStrategy, sync: resolvedSync } : undefined}
->
-  {#snippet plot({ data: rows, width: w, height: h, facetValue })}
-    <ScatterPlot
-      width={w}
-      height={h}
-      data={rows}
-      {x}
-      {y}
-      {z}
-      {r}
-      {styles}
-      {segments}
-      {markers}
-      {scales}
-      {margins}
-      tooltip={tip.enabled
-        ? {
-            format: tip.format ?? defaultFormat,
-            facetId: facetValue ?? '',
-            strategy: tip.strategy,
-            sync: tip.sync,
-            series: tip.series,
-            content: tip.content,
-            anchorX: tip.anchorX,
-            anchorY: tip.anchorY,
-          }
-        : undefined}
-    />
-  {/snippet}
-</BaseChart>

package/dist/charts/scatter/Chart.svelte.d.ts

@@ -1,28 +0,0 @@
-import type { Accessor } from '../../types/plots/data/common';
-import type { ChartProps } from '../../types/charts/props';
-declare function $$render<TRow extends Record<string, unknown>>(): {
-    props: ChartProps<TRow, import("../..").DotStyle> & {
-        r?: Accessor<TRow, number> | number;
-    };
-    exports: {};
-    bindings: "";
-    slots: {};
-    events: {};
-};
-declare class __sveltets_Render<TRow extends Record<string, unknown>> {
-    props(): ReturnType<typeof $$render<TRow>>['props'];
-    events(): ReturnType<typeof $$render<TRow>>['events'];
-    slots(): ReturnType<typeof $$render<TRow>>['slots'];
-    bindings(): "";
-    exports(): {};
-}
-interface $$IsomorphicComponent {
-    new <TRow extends Record<string, unknown>>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TRow>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TRow>['props']>, ReturnType<__sveltets_Render<TRow>['events']>, ReturnType<__sveltets_Render<TRow>['slots']>> & {
-        $$bindings?: ReturnType<__sveltets_Render<TRow>['bindings']>;
-    } & ReturnType<__sveltets_Render<TRow>['exports']>;
-    <TRow extends Record<string, unknown>>(internal: unknown, props: ReturnType<__sveltets_Render<TRow>['props']> & {}): ReturnType<__sveltets_Render<TRow>['exports']>;
-    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
-}
-declare const Chart: $$IsomorphicComponent;
-type Chart<TRow extends Record<string, unknown>> = InstanceType<typeof Chart<TRow>>;
-export default Chart;

package/dist/layout/coordinates/margins.d.ts

@@ -1,16 +0,0 @@
-/**
- * GeoPlot's own margin default — a small, uniform gap on every side, unlike
- * `AUTO_MARGIN_ESTIMATE`'s asymmetric axis-tick-label estimate (extra room
- * on the left/bottom for y tick labels and an x-axis title). A map has no
- * axes to make room for, so borrowing that estimate just left GeoPlot with
- * a lopsided, oversized margin — most visibly a much taller gap under the
- * map than an `inset` marker's own default `margin` (see `insetLayout.ts`),
- * even though both are meant to read as the same edge gap. Matching this
- * constant to that 8px inset default keeps the two visually aligned.
- */
-export declare const GEO_MARGIN_ESTIMATE: {
-    readonly top: 8;
-    readonly right: 8;
-    readonly bottom: 8;
-    readonly left: 8;
-};

package/dist/layout/coordinates/margins.js

@@ -1,11 +0,0 @@
-/**
- * GeoPlot's own margin default — a small, uniform gap on every side, unlike
- * `AUTO_MARGIN_ESTIMATE`'s asymmetric axis-tick-label estimate (extra room
- * on the left/bottom for y tick labels and an x-axis title). A map has no
- * axes to make room for, so borrowing that estimate just left GeoPlot with
- * a lopsided, oversized margin — most visibly a much taller gap under the
- * map than an `inset` marker's own default `margin` (see `insetLayout.ts`),
- * even though both are meant to read as the same edge gap. Matching this
- * constant to that 8px inset default keeps the two visually aligned.
- */
-export const GEO_MARGIN_ESTIMATE = { top: 8, right: 8, bottom: 8, left: 8 };

package/dist/layout/legend/interaction.svelte.d.ts

@@ -1,15 +0,0 @@
-import type { LegendInteractionStore } from '../../types/layout/legend';
-/** Create + register the shared legend-interaction store. Call during component init. */
-export declare function provideLegendInteraction(): LegendInteractionStore;
-/**
- * Read the shared legend-interaction store, or `null` when there is no provider.
- *
- * Only resolves correctly when called during a real descendant component's
- * own `<script>` instantiation, not from inside a `{@render}`ed snippet body
- * — snippets run in their author's scope rather than as a fresh component
- * instance. `BaseChart`'s `plot` snippet gets the same data via its `legend`
- * context field instead, which works from either scope.
- */
-export declare function getLegendInteraction(): LegendInteractionStore | null;
-/** A private legend-interaction store for a legend/plot used outside of a {@link BaseChart}. */
-export declare function createLegendInteraction(): LegendInteractionStore;

package/dist/layout/legend/interaction.svelte.js

@@ -1,32 +0,0 @@
-import { getContext, setContext } from 'svelte';
-import { SvelteMap } from 'svelte/reactivity';
-const LEGEND_INTERACTION_KEY = Symbol('dct-legend-interaction');
-function blank() {
-    return {
-        disabledSeries: new SvelteMap(),
-        continuousRange: null,
-    };
-}
-/** Create + register the shared legend-interaction store. Call during component init. */
-export function provideLegendInteraction() {
-    const store = $state(blank());
-    setContext(LEGEND_INTERACTION_KEY, store);
-    return store;
-}
-/**
- * Read the shared legend-interaction store, or `null` when there is no provider.
- *
- * Only resolves correctly when called during a real descendant component's
- * own `<script>` instantiation, not from inside a `{@render}`ed snippet body
- * — snippets run in their author's scope rather than as a fresh component
- * instance. `BaseChart`'s `plot` snippet gets the same data via its `legend`
- * context field instead, which works from either scope.
- */
-export function getLegendInteraction() {
-    return getContext(LEGEND_INTERACTION_KEY) ?? null;
-}
-/** A private legend-interaction store for a legend/plot used outside of a {@link BaseChart}. */
-export function createLegendInteraction() {
-    const store = $state(blank());
-    return store;
-}