@cfasim-ui/charts 0.7.8 → 0.8.1

package/dist/BarChart/BarChart.d.ts

@@ -228,26 +228,12 @@ interface BarChartProps extends ChartCommonProps {
      */
     valueHeader?: string;
 }
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: Readonly<{
-        tooltip?(props: ChartTooltipBaseProps & {
-            category: string;
-        }): unknown;
-    }> & {
-        tooltip?(props: ChartTooltipBaseProps & {
-            category: string;
-        }): unknown;
-    };
-    refs: {
-        containerRef: HTMLDivElement;
-        svgRef: SVGSVGElement;
-        tooltipRef: HTMLDivElement;
-    };
-    rootEl: any;
+type __VLS_Slots = {
+    tooltip?(props: ChartTooltipBaseProps & {
+        category: string;
+    }): unknown;
 };
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<BarChartProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare const __VLS_base: import('vue').DefineComponent<BarChartProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     hover: (payload: ChartHoverPayload) => any;
 }, string, import('vue').PublicProps, Readonly<BarChartProps> & Readonly<{
     onHover?: ((payload: ChartHoverPayload) => any) | undefined;
@@ -262,14 +248,11 @@ declare const __VLS_component: import('vue').DefineComponent<BarChartProps, {},
     groupGap: number;
     valueGrid: boolean;
     valueAxis: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
-    containerRef: HTMLDivElement;
-    svgRef: SVGSVGElement;
-    tooltipRef: HTMLDivElement;
-}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
+type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;
     };

package/dist/ChartMenu/ChartMenu.d.ts

@@ -14,12 +14,13 @@ type __VLS_Props = {
      */
     isFullscreen?: boolean;
 };
-declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     close: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
 }>, {
     forceDropdown: boolean;
     isFullscreen: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/ChartTooltip/ChartTooltip.d.ts

@@ -10,17 +10,13 @@ type __VLS_Props = {
     /** Offset from anchor in pixels. Default: 8 */
     sideOffset?: number;
 };
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: {
-        default?(_: {}): any;
-        default?(_: {}): any;
-    };
-    refs: {};
-    rootEl: any;
+declare var __VLS_1: {}, __VLS_31: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_31) => any;
 };
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     close: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
@@ -28,9 +24,10 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     sideOffset: number;
     mode: "hover" | "click";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
+type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;
     };

package/dist/ChoroplethMap/ChoroplethMap.d.ts

@@ -1,23 +1,36 @@
-import { nextTick } from 'vue';
 import { Topology } from 'topojson-specification';
 import { NumberFormat } from '@cfasim-ui/shared';
-import { TitleStyle, LabelStyle } from '../_shared/index.js';
+import { MapTheme, TitleStyle, LabelStyle } from '../_shared/index.js';
 import { CityMarker } from './cityLayout.js';
 export type GeoType = "states" | "counties" | "hsas";
 export interface StateData {
     /** FIPS code (e.g. "06" for California, "04015" for a county) or name */
     id: string;
     value: number | string;
+    /**
+     * Geographic level of *this row*, when it differs from the map's `geoType`.
+     * The state the row belongs to is then re-tiled at this level: on a county
+     * map, `{ id: "06", geoType: "states" }` draws California as one merged
+     * shape carrying this value; on a state map, `{ id: "36061", geoType:
+     * "counties" }` breaks New York out into its counties. Rows at the base
+     * level (the common case) leave `geoType` unset. Ignores `dataGeoType` —
+     * an off-level row is looked up by its own id.
+     */
+    geoType?: GeoType;
 }
 export interface ChoroplethColorScale {
-    /** Minimum color (CSS color string). Default: "#e5f0fa" */
+    /**
+     * Minimum color. Any CSS color, including `var()` and `light-dark()`,
+     * resolved against the map's container. Default: "#e5f0fa"
+     */
     min?: string;
-    /** Maximum color (CSS color string). Default: "#08519c" */
+    /** Maximum color (any CSS color, as `min`). Default: "#08519c" */
     max?: string;
 }
 export interface ThresholdStop {
     /** Lower bound (inclusive). Values at or above this threshold get this color. */
     min: number;
+    /** Any CSS color, including `var()` and `light-dark()`. */
     color: string;
     /** Optional label for the legend (defaults to the min value) */
     label?: string;
@@ -25,7 +38,7 @@ export interface ThresholdStop {
 export interface CategoricalStop {
     /** The categorical value to match */
     value: string;
-    /** CSS color string */
+    /** Any CSS color, including `var()` and `light-dark()`. */
     color: string;
 }
 /**
@@ -46,8 +59,8 @@ export interface FocusItem {
      * useful when stacking multiple outlines of different geoTypes. */
     style?: FocusStyle;
     /** Stroke color for the outline. In-place highlights (items in the
-     * base geoType) default to pure black/white following the theme
-     * (`light-dark(#000, #fff)`); cross-geoType overlay paths default to
+     * base geoType) default to the theme's `highlight` (pure black/white
+     * following the color scheme); cross-geoType overlay paths default to
      * `"#fff"`. */
     stroke?: string;
     /** Outline width in CSS px. Defaults to the map's stroke width + 1
@@ -69,7 +82,10 @@ type __VLS_Props = {
      * with its parent HSA's value) or by state values, without changing
      * the rendered/interactive geometry. Supported combinations:
      * `counties` ← `hsas`, `counties` ← `states`, `hsas` ← `states`.
-     * When unset, data ids must match the base `geoType`.
+     * When unset, data ids must match the base `geoType`. Re-keys the whole
+     * dataset — to mix levels on one map (a county map where California
+     * reports one statewide value), set `geoType` on the individual rows
+     * instead.
      */
     dataGeoType?: GeoType;
     /**
@@ -118,9 +134,17 @@ type __VLS_Props = {
     ariaLabel?: string;
     /** Styling for the legend (title, swatch labels, and continuous-scale ticks). */
     legendStyle?: LabelStyle;
-    noDataColor?: string;
-    strokeColor?: string;
-    strokeWidth?: number;
+    /**
+     * Map paint styling: base fill for features without data, feature
+     * strokes, the state-borders mesh, an exterior outline, a background
+     * wash, and the hover/focus highlight. Every color accepts any CSS
+     * color (`var()`, `light-dark()`, `color-mix()`), resolved against
+     * the map's container and re-applied automatically when the page
+     * theme changes. Defaults route through `--choropleth-*` custom
+     * properties (e.g. `--choropleth-outline` enables the exterior
+     * outline), so a stylesheet alone can theme every map. See `MapTheme`.
+     */
+    theme?: MapTheme;
     menu?: boolean | string;
     /** Show legend. Default: true */
     legend?: boolean;
@@ -269,99 +293,10 @@ interface TooltipPayload {
     value?: number | string;
     feature: ChoroplethFeature;
 }
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: Readonly<{
-        tooltip?(props: TooltipPayload): unknown;
-    }> & {
-        tooltip?(props: TooltipPayload): unknown;
-    };
-    refs: {
-        containerRef: HTMLDivElement;
-        canvasRef: HTMLCanvasElement;
-        svgRef: SVGSVGElement;
-        mapGroupRef: SVGGElement;
-        baseGroupRef: SVGGElement;
-        overlayGroupRef: SVGGElement;
-        cityOverlayRef: SVGSVGElement;
-        cityLayerRef: SVGGElement;
-        tooltipChildRef: ({
-            $: import('vue').ComponentInternalInstance;
-            $data: {};
-            $props: {
-                readonly mode?: "float" | "sheet" | undefined;
-            } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
-            $attrs: import('vue').Attrs;
-            $refs: {
-                [x: string]: unknown;
-            } & {
-                root: HTMLDivElement;
-            };
-            $slots: Readonly<{
-                [name: string]: import('vue').Slot<any> | undefined;
-            }>;
-            $root: import('vue').ComponentPublicInstance | null;
-            $parent: import('vue').ComponentPublicInstance | null;
-            $host: Element | null;
-            $emit: (event: string, ...args: any[]) => void;
-            $el: any;
-            $options: import('vue').ComponentOptionsBase<Readonly<{
-                mode?: "float" | "sheet";
-            }> & Readonly<{}>, {
-                setData(next: import('./ChoroplethTooltip').ChoroplethTooltipData | null): void;
-                setOpen(next: boolean): void;
-                getEl(): HTMLDivElement | null;
-            }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
-                mode: "float" | "sheet";
-            }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
-                beforeCreate?: (() => void) | (() => void)[];
-                created?: (() => void) | (() => void)[];
-                beforeMount?: (() => void) | (() => void)[];
-                mounted?: (() => void) | (() => void)[];
-                beforeUpdate?: (() => void) | (() => void)[];
-                updated?: (() => void) | (() => void)[];
-                activated?: (() => void) | (() => void)[];
-                deactivated?: (() => void) | (() => void)[];
-                beforeDestroy?: (() => void) | (() => void)[];
-                beforeUnmount?: (() => void) | (() => void)[];
-                destroyed?: (() => void) | (() => void)[];
-                unmounted?: (() => void) | (() => void)[];
-                renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-                renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-                errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
-            };
-            $forceUpdate: () => void;
-            $nextTick: typeof nextTick;
-            $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
-        } & Readonly<{
-            mode: "float" | "sheet";
-        }> & Omit<Readonly<{
-            mode?: "float" | "sheet";
-        }> & Readonly<{}>, "mode" | "setData" | "setOpen" | "getEl"> & {
-            setData: (next: import('./ChoroplethTooltip').ChoroplethTooltipData | null) => void;
-            setOpen: (next: boolean) => void;
-            getEl: () => HTMLDivElement | null;
-        } & {} & import('vue').ComponentCustomProperties & {} & {
-            $slots: {
-                default?(_: {
-                    id: string;
-                    name: string;
-                    value?: number | string | undefined;
-                    feature: unknown;
-                }): any;
-                default?(_: {
-                    id: string;
-                    name: string;
-                    value?: number | string | undefined;
-                    feature: unknown;
-                }): any;
-            };
-        }) | null;
-    };
-    rootEl: any;
+type __VLS_Slots = {
+    tooltip?(props: TooltipPayload): unknown;
 };
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     stateClick: (state: {
         id: string;
         name: string;
@@ -389,11 +324,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     legend: boolean;
     menu: boolean | string;
     tooltipClamp: "none" | "chart" | "window";
-    strokeWidth: number;
     geoType: GeoType;
     tightFit: boolean | number;
-    noDataColor: string;
-    strokeColor: string;
     zoom: boolean;
     zoomMode: "activate" | "scroll";
     touchExpand: boolean;
@@ -402,91 +334,11 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     focusZoom: boolean;
     renderer: "svg" | "canvas";
     citiesMinZoom: number;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
-    containerRef: HTMLDivElement;
-    canvasRef: HTMLCanvasElement;
-    svgRef: SVGSVGElement;
-    mapGroupRef: SVGGElement;
-    baseGroupRef: SVGGElement;
-    overlayGroupRef: SVGGElement;
-    cityOverlayRef: SVGSVGElement;
-    cityLayerRef: SVGGElement;
-    tooltipChildRef: ({
-        $: import('vue').ComponentInternalInstance;
-        $data: {};
-        $props: {
-            readonly mode?: "float" | "sheet" | undefined;
-        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
-        $attrs: import('vue').Attrs;
-        $refs: {
-            [x: string]: unknown;
-        } & {
-            root: HTMLDivElement;
-        };
-        $slots: Readonly<{
-            [name: string]: import('vue').Slot<any> | undefined;
-        }>;
-        $root: import('vue').ComponentPublicInstance | null;
-        $parent: import('vue').ComponentPublicInstance | null;
-        $host: Element | null;
-        $emit: (event: string, ...args: any[]) => void;
-        $el: any;
-        $options: import('vue').ComponentOptionsBase<Readonly<{
-            mode?: "float" | "sheet";
-        }> & Readonly<{}>, {
-            setData(next: import('./ChoroplethTooltip').ChoroplethTooltipData | null): void;
-            setOpen(next: boolean): void;
-            getEl(): HTMLDivElement | null;
-        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
-            mode: "float" | "sheet";
-        }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
-            beforeCreate?: (() => void) | (() => void)[];
-            created?: (() => void) | (() => void)[];
-            beforeMount?: (() => void) | (() => void)[];
-            mounted?: (() => void) | (() => void)[];
-            beforeUpdate?: (() => void) | (() => void)[];
-            updated?: (() => void) | (() => void)[];
-            activated?: (() => void) | (() => void)[];
-            deactivated?: (() => void) | (() => void)[];
-            beforeDestroy?: (() => void) | (() => void)[];
-            beforeUnmount?: (() => void) | (() => void)[];
-            destroyed?: (() => void) | (() => void)[];
-            unmounted?: (() => void) | (() => void)[];
-            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-            errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
-        };
-        $forceUpdate: () => void;
-        $nextTick: typeof nextTick;
-        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
-    } & Readonly<{
-        mode: "float" | "sheet";
-    }> & Omit<Readonly<{
-        mode?: "float" | "sheet";
-    }> & Readonly<{}>, "mode" | "setData" | "setOpen" | "getEl"> & {
-        setData: (next: import('./ChoroplethTooltip').ChoroplethTooltipData | null) => void;
-        setOpen: (next: boolean) => void;
-        getEl: () => HTMLDivElement | null;
-    } & {} & import('vue').ComponentCustomProperties & {} & {
-        $slots: {
-            default?(_: {
-                id: string;
-                name: string;
-                value?: number | string | undefined;
-                feature: unknown;
-            }): any;
-            default?(_: {
-                id: string;
-                name: string;
-                value?: number | string | undefined;
-                feature: unknown;
-            }): any;
-        };
-    }) | null;
-}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
+type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;
     };

package/dist/ChoroplethMap/ChoroplethTooltip.d.ts

@@ -15,41 +15,34 @@ type __VLS_Props = {
      */
     mode?: "float" | "sheet";
 };
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: {
-        default?(_: {
-            id: string;
-            name: string;
-            value?: number | string | undefined;
-            feature: unknown;
-        }): any;
-        default?(_: {
-            id: string;
-            name: string;
-            value?: number | string | undefined;
-            feature: unknown;
-        }): any;
-    };
-    refs: {
-        root: HTMLDivElement;
-    };
-    rootEl: any;
+declare var __VLS_7: {
+    id: string;
+    name: string;
+    value?: number | string | undefined;
+    feature: unknown;
+}, __VLS_9: {
+    id: string;
+    name: string;
+    value?: number | string | undefined;
+    feature: unknown;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_7) => any;
+} & {
+    default?: (props: typeof __VLS_9) => any;
 };
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     setData(next: ChoroplethTooltipData | null): void;
     /** Sheet-mode visibility (float mode is driven imperatively via getEl). */
     setOpen(next: boolean): void;
     getEl(): HTMLDivElement | null;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     mode: "float" | "sheet";
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
-    root: HTMLDivElement;
-}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
+type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;
     };

package/dist/ChoroplethMap/canvasLayer.d.ts

@@ -9,13 +9,19 @@ export interface CanvasScene {
     items: SceneItem[];
     indexById: Map<string, number>;
     /**
-     * Every feature outline concatenated into one path — features share a
+     * Every feature stroke concatenated into one path — features share a
      * stroke color, and one native stroke call beats thousands (WebKit's
      * canvas2D especially).
      */
-    outlines: Path2D | null;
+    featureStrokes: Path2D | null;
     /** State-borders mesh (counties / hsas mode). */
     borders: Path2D | null;
+    /**
+     * Exterior boundary of the rendered geography (theme.outline). Built
+     * lazily by the component when the outline resolves visible, so it is
+     * mutable scene state rather than a buildScene input.
+     */
+    exterior: Path2D | null;
 }
 export interface CanvasView {
     dpr: number;
@@ -45,6 +51,16 @@ export interface CanvasBaseState {
     strokeColor: string;
     /** Base feature stroke width in CSS px (effectiveStrokeWidth). */
     strokeWidth: number;
+    /** State-borders mesh color (resolved theme.borders). */
+    bordersColor: string;
+    /** State-borders mesh width in CSS px; 0 disables. */
+    bordersWidth: number;
+    /** Exterior outline color; undefined = off (resolved theme.outline). */
+    outlineColor: string | undefined;
+    /** Exterior outline width in CSS px; 0 disables. */
+    outlineWidth: number;
+    /** Background wash painted before fills; undefined = off. */
+    background: string | undefined;
     /** Resolved highlight color (light-dark() can't paint on canvas). */
     highlightStroke: string;
     focused: Map<string, CanvasHighlightItem>;
@@ -60,10 +76,11 @@ export declare function buildScene(features: Array<{
  * base (focused features are already highlighted in the base itself). */
 export declare function drawHoverHighlight(ctx: CanvasRenderingContext2D, scene: CanvasScene, view: CanvasView, state: CanvasBaseState, hoveredId: string | null): void;
 /**
- * Everything but the transient hover: clear, fills, outlines, borders, focus
- * highlights, overlays. Split out so the component can cache this to an
- * offscreen canvas and, on a hover-only change, blit it back + redraw the one
- * highlight instead of re-filling every feature.
+ * Everything but the transient hover: clear, background, fills, feature
+ * strokes, borders, exterior outline, focus highlights, overlays. Split out
+ * so the component can cache this to an offscreen canvas and, on a
+ * hover-only change, blit it back + redraw the one highlight instead of
+ * re-filling every feature.
  */
 export declare function drawBase(ctx: CanvasRenderingContext2D, scene: CanvasScene, view: CanvasView, state: CanvasDrawState): void;
 /** One-shot full repaint: the base pass plus the hover highlight on top. */

package/dist/ChoroplethMap/cityLayout.d.ts

@@ -4,8 +4,9 @@ export interface CityMarker {
     coordinates: [number, number];
     /**
      * Mark as a capital: the label gets first pick during placement and is never
-     * dropped for collisions (rendered slightly emphasized). The marker itself is
-     * a plain dot, same as any other city.
+     * dropped for collisions. It renders like any other label (with a
+     * `choropleth-city-label-capital` class to style if you want), and the marker
+     * is a plain dot, same as any other city.
      */
     capital?: boolean;
     /**

package/dist/ChoroplethMap/mixedGeo.d.ts

@@ -0,0 +1,74 @@
+import { GeoType } from './ChoroplethMap';
+/** Minimal shape of the GeoJSON features this module shuffles around. */
+export interface MixFeature {
+    id?: string | number | null;
+    properties?: {
+        name?: string;
+    } | null;
+}
+/** id → feature and name → id indexes for one geographic level. */
+export interface LevelLookup<F extends MixFeature = MixFeature> {
+    byId: Map<string, F>;
+    byName: Map<string, string>;
+}
+/**
+ * Lazily resolves the lookup for a level, so a map that never mixes never pays
+ * to index the levels it doesn't render. Returns null when the topology can't
+ * supply that level (e.g. "counties" from a states-only topology, or "hsas"
+ * before the lazy HSA chunk loads).
+ */
+export type LevelResolver<F extends MixFeature = MixFeature> = (level: GeoType) => LevelLookup<F> | null;
+/**
+ * 2-digit state FIPS a feature id belongs to, or null when it can't be
+ * determined. States and counties carry it as their first two digits; HSA
+ * codes need the FIPS→HSA table (inverted into `hsaToState`), because an HSA
+ * code isn't state-prefixed. No HSA spans two states, so the mapping is total.
+ */
+export declare function stateOfId(level: GeoType, id: string, hsaToState?: ReadonlyMap<string, string> | null): string | null;
+/** A `data` row as far as mixing is concerned. */
+export interface MixRow {
+    id: string;
+    geoType?: GeoType;
+}
+export interface OverrideResolution {
+    /** state FIPS → the level that state renders at. */
+    overrides: Map<string, GeoType>;
+    /** Row ids whose state couldn't be resolved (bad id, or level unavailable). */
+    unresolved: string[];
+    /**
+     * Row ids that named an already-claimed state at a different level. The first
+     * row wins; these are reported so the caller can warn.
+     */
+    conflicts: string[];
+}
+/**
+ * Collects the per-state level overrides implied by `rows`. Rows without a
+ * `geoType`, or whose `geoType` matches the base map, are plain data and are
+ * ignored here.
+ */
+export declare function resolveGeoOverrides(rows: readonly MixRow[] | undefined, baseGeoType: GeoType, getLevel: LevelResolver, hsaToState?: ReadonlyMap<string, string> | null): OverrideResolution;
+/**
+ * Serializes overrides into a comparable key. The caller derives the override
+ * map from this string so its identity only changes when the *set* of overrides
+ * does — otherwise every `data` update would rebuild the whole feature tree.
+ */
+export declare function serializeOverrides(overrides: Map<string, GeoType>): string;
+/** Inverse of `serializeOverrides`. */
+export declare function parseOverrides(key: string): Map<string, GeoType>;
+export interface MixedFeatures<F extends MixFeature> {
+    features: F[];
+    /**
+     * Feature id → level, for substituted features only. Ids absent from the map
+     * render at the base `geoType`.
+     */
+    levelById: Map<string, GeoType>;
+}
+/**
+ * Replaces every overridden state's base features with that state's features at
+ * the override level. Returns `base` untouched when there's nothing to mix, so
+ * the common case costs one `size` check.
+ *
+ * `scopeFips` mirrors the map's single-state mode: substituted features outside
+ * the scoped state are dropped, exactly as the base set already is.
+ */
+export declare function mixFeatures<F extends MixFeature>(base: readonly F[], baseGeoType: GeoType, overrides: Map<string, GeoType>, getLevel: LevelResolver<F>, hsaToState?: ReadonlyMap<string, string> | null, scopeFips?: string | null): MixedFeatures<F>;

package/dist/ChoroplethMap/mixedGeo.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/DataTable/DataTable.d.ts

@@ -71,10 +71,11 @@ type __VLS_Props = {
     /** Stretch the table to fill its container's width. */
     fullWidth?: boolean;
 };
-declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     menu: boolean | string;
     downloadButton: boolean;
     downloadMenuLink: string;
     fullWidth: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;