@texturehq/edges 1.3.1 → 1.5.0

package/dist/{server-Utz6Sv9w.d.ts → server-BMdETIqh.d.cts}

@@ -4,7 +4,7 @@ import React__default, { ReactNode } from 'react';
 import * as PhosphorIcons from '@phosphor-icons/react';
 import { IconProps as IconProps$1 } from '@phosphor-icons/react';
 import { DateValue, DateFieldProps as DateFieldProps$1, ValidationResult, MeterProps as MeterProps$1 } from 'react-aria-components';
-import { ViewState } from 'react-map-gl';
+import { ViewState, MapRef } from 'react-map-gl';
 import * as d3_scale from 'd3-scale';
 import { ScaleTime, ScaleLinear } from 'd3-scale';
 
@@ -634,8 +634,45 @@ declare const Logo: ({ className, showWordmark, width, fill }: LogoProps) => rea
  * A clean, developer-friendly API for defining map layers that abstracts
  * away Mapbox jargon while supporting vector tiles, GeoJSON, and custom markers.
  */
+/**
+ * Sequential palette color schemes (light → dark gradients)
+ * Use for numeric data that goes from low to high (population, temperature, elevation, etc.)
+ */
+type SequentialScheme = "viridis" | "magma" | "rose" | "cerulean" | "forest";
+/**
+ * Diverging palette color schemes (two-hue gradients with light center)
+ * Use for numeric data with a meaningful center point (anomalies, differences, profit/loss, etc.)
+ */
+type DivergingScheme = "orangeYellowSeafoam" | "redYellowBlue" | "redBlue";
 /**
  * Color specification - supports design tokens, hex values, or property-based mapping
+ *
+ * @example
+ * // Design token
+ * { token: "brand-primary" }
+ *
+ * @example
+ * // Hex color
+ * { hex: "#ff0000" }
+ *
+ * @example
+ * // Property-based mapping (works with all layer types)
+ * { by: "voltage_level", mapping: { high: { hex: "#ff0000" }, low: { hex: "#00ff00" } } }
+ *
+ * @example
+ * // Categorical auto-assignment (automatically assigns colors from palette)
+ * // ⚠️ ONLY works with GeoJSON layers that provide data as an object (not URL)
+ * { by: "type", palette: "categorical" }
+ *
+ * @example
+ * // Sequential palette (numeric data, light to dark)
+ * // ⚠️ ONLY works with GeoJSON layers that provide data as an object (not URL)
+ * { by: "population_density", palette: "sequential", scheme: "viridis", scale: "auto" }
+ *
+ * @example
+ * // Diverging palette (numeric data with meaningful center)
+ * // ⚠️ ONLY works with GeoJSON layers that provide data as an object (not URL)
+ * { by: "temp_anomaly", palette: "diverging", scheme: "redYellowBlue", center: 0 }
  */
 type ColorSpec = {
     token: string;
@@ -644,6 +681,27 @@ type ColorSpec = {
 } | {
     by: string;
     mapping: Record<string, ColorSpec>;
+} | {
+    by: string;
+    palette: "categorical";
+    scale?: "auto";
+} | {
+    by: string;
+    palette: "sequential";
+    scheme?: SequentialScheme;
+    scale?: {
+        min: number;
+        max: number;
+    } | "auto";
+} | {
+    by: string;
+    palette: "diverging";
+    scheme?: DivergingScheme;
+    center: number | "median" | "mean";
+    scale?: {
+        min: number;
+        max: number;
+    } | "auto";
 };
 /**
  * Zoom-based interpolation for numeric values
@@ -994,6 +1052,25 @@ interface CustomControl extends BaseControl {
  */
 type MapControl = NavigationControl | LayersControl | SearchControl | ListControl | CustomControl;
 
+/**
+ * Ref handle for programmatic map control
+ */
+interface InteractiveMapHandle {
+    /**
+     * Show a tooltip for a specific feature
+     * @param featureId - The feature ID to show tooltip for
+     * @param layerId - Optional layer ID to narrow the search
+     */
+    showTooltip: (featureId: string | number, layerId?: string) => void;
+    /**
+     * Hide the currently active tooltip
+     */
+    hideTooltip: () => void;
+    /**
+     * Get the underlying Mapbox map instance
+     */
+    getMap: () => MapRef | null;
+}
 interface InteractiveMapProps {
     /**
      * Initial camera position
@@ -1077,10 +1154,19 @@ interface InteractiveMapProps {
         headers?: Record<string, string>;
     };
     /**
-     * Show loading state overlay
+     * Show loading state overlay (for external data loading)
+     * The map automatically shows a loading state while Mapbox initializes.
+     * Use this prop if you need to show loading while fetching additional data.
      * @default false
      */
     isLoading?: boolean;
+    /**
+     * Callback fired when the map finishes loading
+     * Called after Mapbox is fully initialized and initial tiles are loaded.
+     * The map handles its own loading state internally, but you can use this
+     * callback for analytics, initializing overlays, or other side effects.
+     */
+    onLoad?: () => void;
     /**
      * Map controls configuration
      *
@@ -1109,7 +1195,7 @@ interface InteractiveMapProps {
      */
     controls?: MapControl[] | "default" | false;
 }
-declare function InteractiveMap({ initialViewState, viewState, onViewStateChange, scrollEnabled, className, previewMode, previewModeCta, onPreviewModePress, mapType, layers, mapboxAccessToken, transformRequest, isLoading, controls, }: InteractiveMapProps): react_jsx_runtime.JSX.Element;
+declare const InteractiveMap: React__default.ForwardRefExoticComponent<InteractiveMapProps & React__default.RefAttributes<InteractiveMapHandle>>;
 
 interface StaticMapProps {
     /**
@@ -1174,6 +1260,11 @@ interface StaticMapProps {
      * @default true
      */
     showMarker?: boolean;
+    /**
+     * Callback fired when the map finishes loading
+     * Useful for knowing when Mapbox is fully initialized and tiles are loaded
+     */
+    onLoad?: () => void;
     /**
      * Additional CSS classes
      */
@@ -1187,7 +1278,7 @@ interface StaticMapProps {
  *
  * Automatically adapts to light/dark mode using the global ColorModeProvider.
  */
-declare function StaticMap({ width, height, initialViewState, isLoading, mapType, layers, mapboxAccessToken, showMarker, className, }: StaticMapProps): react_jsx_runtime.JSX.Element;
+declare function StaticMap({ width, height, initialViewState, isLoading, mapType, layers, mapboxAccessToken, showMarker, onLoad, className, }: StaticMapProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Represents a geographic point with coordinates

package/dist/{server-Utz6Sv9w.d.cts → server-BMdETIqh.d.ts}

@@ -4,7 +4,7 @@ import React__default, { ReactNode } from 'react';
 import * as PhosphorIcons from '@phosphor-icons/react';
 import { IconProps as IconProps$1 } from '@phosphor-icons/react';
 import { DateValue, DateFieldProps as DateFieldProps$1, ValidationResult, MeterProps as MeterProps$1 } from 'react-aria-components';
-import { ViewState } from 'react-map-gl';
+import { ViewState, MapRef } from 'react-map-gl';
 import * as d3_scale from 'd3-scale';
 import { ScaleTime, ScaleLinear } from 'd3-scale';
 
@@ -634,8 +634,45 @@ declare const Logo: ({ className, showWordmark, width, fill }: LogoProps) => rea
  * A clean, developer-friendly API for defining map layers that abstracts
  * away Mapbox jargon while supporting vector tiles, GeoJSON, and custom markers.
  */
+/**
+ * Sequential palette color schemes (light → dark gradients)
+ * Use for numeric data that goes from low to high (population, temperature, elevation, etc.)
+ */
+type SequentialScheme = "viridis" | "magma" | "rose" | "cerulean" | "forest";
+/**
+ * Diverging palette color schemes (two-hue gradients with light center)
+ * Use for numeric data with a meaningful center point (anomalies, differences, profit/loss, etc.)
+ */
+type DivergingScheme = "orangeYellowSeafoam" | "redYellowBlue" | "redBlue";
 /**
  * Color specification - supports design tokens, hex values, or property-based mapping
+ *
+ * @example
+ * // Design token
+ * { token: "brand-primary" }
+ *
+ * @example
+ * // Hex color
+ * { hex: "#ff0000" }
+ *
+ * @example
+ * // Property-based mapping (works with all layer types)
+ * { by: "voltage_level", mapping: { high: { hex: "#ff0000" }, low: { hex: "#00ff00" } } }
+ *
+ * @example
+ * // Categorical auto-assignment (automatically assigns colors from palette)
+ * // ⚠️ ONLY works with GeoJSON layers that provide data as an object (not URL)
+ * { by: "type", palette: "categorical" }
+ *
+ * @example
+ * // Sequential palette (numeric data, light to dark)
+ * // ⚠️ ONLY works with GeoJSON layers that provide data as an object (not URL)
+ * { by: "population_density", palette: "sequential", scheme: "viridis", scale: "auto" }
+ *
+ * @example
+ * // Diverging palette (numeric data with meaningful center)
+ * // ⚠️ ONLY works with GeoJSON layers that provide data as an object (not URL)
+ * { by: "temp_anomaly", palette: "diverging", scheme: "redYellowBlue", center: 0 }
  */
 type ColorSpec = {
     token: string;
@@ -644,6 +681,27 @@ type ColorSpec = {
 } | {
     by: string;
     mapping: Record<string, ColorSpec>;
+} | {
+    by: string;
+    palette: "categorical";
+    scale?: "auto";
+} | {
+    by: string;
+    palette: "sequential";
+    scheme?: SequentialScheme;
+    scale?: {
+        min: number;
+        max: number;
+    } | "auto";
+} | {
+    by: string;
+    palette: "diverging";
+    scheme?: DivergingScheme;
+    center: number | "median" | "mean";
+    scale?: {
+        min: number;
+        max: number;
+    } | "auto";
 };
 /**
  * Zoom-based interpolation for numeric values
@@ -994,6 +1052,25 @@ interface CustomControl extends BaseControl {
  */
 type MapControl = NavigationControl | LayersControl | SearchControl | ListControl | CustomControl;
 
+/**
+ * Ref handle for programmatic map control
+ */
+interface InteractiveMapHandle {
+    /**
+     * Show a tooltip for a specific feature
+     * @param featureId - The feature ID to show tooltip for
+     * @param layerId - Optional layer ID to narrow the search
+     */
+    showTooltip: (featureId: string | number, layerId?: string) => void;
+    /**
+     * Hide the currently active tooltip
+     */
+    hideTooltip: () => void;
+    /**
+     * Get the underlying Mapbox map instance
+     */
+    getMap: () => MapRef | null;
+}
 interface InteractiveMapProps {
     /**
      * Initial camera position
@@ -1077,10 +1154,19 @@ interface InteractiveMapProps {
         headers?: Record<string, string>;
     };
     /**
-     * Show loading state overlay
+     * Show loading state overlay (for external data loading)
+     * The map automatically shows a loading state while Mapbox initializes.
+     * Use this prop if you need to show loading while fetching additional data.
      * @default false
      */
     isLoading?: boolean;
+    /**
+     * Callback fired when the map finishes loading
+     * Called after Mapbox is fully initialized and initial tiles are loaded.
+     * The map handles its own loading state internally, but you can use this
+     * callback for analytics, initializing overlays, or other side effects.
+     */
+    onLoad?: () => void;
     /**
      * Map controls configuration
      *
@@ -1109,7 +1195,7 @@ interface InteractiveMapProps {
      */
     controls?: MapControl[] | "default" | false;
 }
-declare function InteractiveMap({ initialViewState, viewState, onViewStateChange, scrollEnabled, className, previewMode, previewModeCta, onPreviewModePress, mapType, layers, mapboxAccessToken, transformRequest, isLoading, controls, }: InteractiveMapProps): react_jsx_runtime.JSX.Element;
+declare const InteractiveMap: React__default.ForwardRefExoticComponent<InteractiveMapProps & React__default.RefAttributes<InteractiveMapHandle>>;
 
 interface StaticMapProps {
     /**
@@ -1174,6 +1260,11 @@ interface StaticMapProps {
      * @default true
      */
     showMarker?: boolean;
+    /**
+     * Callback fired when the map finishes loading
+     * Useful for knowing when Mapbox is fully initialized and tiles are loaded
+     */
+    onLoad?: () => void;
     /**
      * Additional CSS classes
      */
@@ -1187,7 +1278,7 @@ interface StaticMapProps {
  *
  * Automatically adapts to light/dark mode using the global ColorModeProvider.
  */
-declare function StaticMap({ width, height, initialViewState, isLoading, mapType, layers, mapboxAccessToken, showMarker, className, }: StaticMapProps): react_jsx_runtime.JSX.Element;
+declare function StaticMap({ width, height, initialViewState, isLoading, mapType, layers, mapboxAccessToken, showMarker, onLoad, className, }: StaticMapProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Represents a geographic point with coordinates