@texturehq/edges 2.1.1 → 2.1.2

package/dist/{colors-DxW1GSLj.d.ts → colors-BOuEkfS-.d.ts}

@@ -1240,6 +1240,24 @@ interface VectorLayerSpec extends BaseLayerSpec {
     tileset: string;
     /** Source layer name within the tileset */
     sourceLayer: string;
+    /**
+     * Promote a feature property to be the feature `id`.
+     *
+     * Vector-tile features usually have no usable top-level `id`, so Mapbox
+     * feature-state (data-joins, hover/selection highlighting) has nothing to key
+     * on. `promoteId` tells Mapbox to use the named property as the id, which is
+     * what lets `map.setFeatureState({ id }, …)` line up with tile features —
+     * e.g. joining a metric keyed by region code onto choropleth polygons.
+     *
+     * Accepts either a single property name applied to this layer's source layer,
+     * or an object mapping `{ [sourceLayer]: propertyName }` when a tileset
+     * exposes several source layers. Matches Mapbox GL's `promoteId` spec.
+     *
+     * Must be set when the source is created — Mapbox cannot add it to an
+     * existing source. Only needed for feature-state joins; static
+     * color-by-property (`style.color = { by, mapping }`) does not require it.
+     */
+    promoteId?: string | Record<string, string>;
     /** How to render the geometry */
     renderAs: RenderType;
     /** Visual styling */

package/dist/{colors-C_3RVUMs.d.cts → colors-CdKL3iAY.d.cts}

@@ -1240,6 +1240,24 @@ interface VectorLayerSpec extends BaseLayerSpec {
     tileset: string;
     /** Source layer name within the tileset */
     sourceLayer: string;
+    /**
+     * Promote a feature property to be the feature `id`.
+     *
+     * Vector-tile features usually have no usable top-level `id`, so Mapbox
+     * feature-state (data-joins, hover/selection highlighting) has nothing to key
+     * on. `promoteId` tells Mapbox to use the named property as the id, which is
+     * what lets `map.setFeatureState({ id }, …)` line up with tile features —
+     * e.g. joining a metric keyed by region code onto choropleth polygons.
+     *
+     * Accepts either a single property name applied to this layer's source layer,
+     * or an object mapping `{ [sourceLayer]: propertyName }` when a tileset
+     * exposes several source layers. Matches Mapbox GL's `promoteId` spec.
+     *
+     * Must be set when the source is created — Mapbox cannot add it to an
+     * existing source. Only needed for feature-state joins; static
+     * color-by-property (`style.color = { by, mapping }`) does not require it.
+     */
+    promoteId?: string | Record<string, string>;
     /** How to render the geometry */
     renderAs: RenderType;
     /** Visual styling */