feat(plugins): expose external layer groups

Author: giswqs

apps/geolibre-desktop/src/hooks/usePlugins.ts

@@ -835,6 +835,9 @@ export function createAppAPI(mapControllerRef?: RefObject<MapController | null>)
       return state === undefined ? true : manager.applyPluginState(pluginId, api, state);
     },
     queryOvertureFeatures,
+    addLayerGroup: (name?: string, layerIds?: string[]) =>
+      useAppStore.getState().addLayerGroup(name, layerIds),
+    removeLayerGroup: (id: string) => useAppStore.getState().removeLayerGroup(id),
     fitBounds: (bounds: [number, number, number, number]) =>
       mapControllerRef?.current?.fitBounds(bounds),
     getMap: () => mapControllerRef?.current?.getMap() ?? null,

apps/geolibre-desktop/src/lib/external-native-layer.ts

@@ -76,5 +76,6 @@ export function createExternalNativeStoreLayer(
     beforeId: registration.beforeId ?? existing?.beforeId,
     geojson: registration.geojson ?? existing?.geojson,
     sourcePath: registration.sourcePath ?? existing?.sourcePath,
+    groupId: registration.groupId ?? existing?.groupId,
   };
 }

packages/plugins/src/types.ts

@@ -26,6 +26,8 @@ export type GeoLibreBuiltInMapControl =
 export interface GeoLibreExternalNativeLayerRegistration {
   id: string;
   name: string;
+  /** Optional host layer-group id that should contain this layer. */
+  groupId?: string;
   type?: GeoLibreLayer["type"];
   source?: Record<string, unknown>;
   geojson?: FeatureCollection;
@@ -427,6 +429,13 @@ export interface GeoLibreAppAPI {
    * PMTiles integration. The host enforces tile and feature limits.
    */
   queryOvertureFeatures?: (query: GeoLibreOvertureQuery) => Promise<GeoLibreOvertureQueryResult>;
+  /**
+   * Create a named Layers-panel group, optionally assigning existing layer ids
+   * to it, and return the new group id.
+   */
+  addLayerGroup?: (name?: string, layerIds?: string[]) => string;
+  /** Remove a Layers-panel group without removing its child layers. */
+  removeLayerGroup?: (id: string) => void;
   fitBounds?: (bounds: [number, number, number, number]) => void;
   getMap?: () => MapLibreMap | null;
   /**

tests/external-native-layer.test.ts

@@ -159,4 +159,15 @@ describe("createExternalNativeStoreLayer", () => {
 
     assert.equal(layer.visible, false);
   });
+
+  it("assigns and preserves the requested host layer group", () => {
+    const grouped = createExternalNativeStoreLayer(baseRegistration({ groupId: "event-imagery" }));
+    assert.equal(grouped.groupId, "event-imagery");
+
+    const updated = createExternalNativeStoreLayer(
+      baseRegistration({ name: "Updated Plugin Layer" }),
+      grouped,
+    );
+    assert.equal(updated.groupId, "event-imagery");
+  });
 });