fix: externalize @tanstack/react-query in build and fix StacApiProvider initialization order

- Add @tanstack/react-query to vite external dependencies to prevent bundling
- Refactor StacApiProvider to split into inner/outer components, ensuring QueryClient is available before any React Query hooks execute
- Add @tanstack/react-query peer dependency to example app package.json

Author: AliceR

example/package.json

@@ -5,6 +5,7 @@
   "dependencies": {
     "@mapbox/mapbox-gl-draw": "^1.3.0",
     "@mapbox/mapbox-gl-draw-static-mode": "^1.0.1",
+    "@tanstack/react-query": "^5.90.10",
     "@testing-library/jest-dom": "^5.14.1",
     "@testing-library/react": "^13.0.0",
     "@testing-library/user-event": "^13.2.1",

example/yarn.lock

@@ -2474,6 +2474,24 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@tanstack/query-core@npm:5.90.10":
+  version: 5.90.10
+  resolution: "@tanstack/query-core@npm:5.90.10"
+  checksum: 10c0/c51762d4413f99886af24d0a4897e286233fae305131df2db8294c26b1375e74e87d0cd7dafbe1b7d23338221fca0304c05058dd9a909c0988a8829d8f7283e6
+  languageName: node
+  linkType: hard
+
+"@tanstack/react-query@npm:^5.90.10":
+  version: 5.90.10
+  resolution: "@tanstack/react-query@npm:5.90.10"
+  dependencies:
+    "@tanstack/query-core": "npm:5.90.10"
+  peerDependencies:
+    react: ^18 || ^19
+  checksum: 10c0/a852c44fafb0331a47ba8b46f96bc6c3c66a1bfbec8a09de15fc0ba6fd1b867da42c4974f83489a03cc4d7fd9fa40ec23b8790d2f69a930ca63b85f2bf4a4885
+  languageName: node
+  linkType: hard
+
 "@testing-library/dom@npm:^8.5.0":
   version: 8.13.0
   resolution: "@testing-library/dom@npm:8.13.0"
@@ -5839,6 +5857,7 @@ __metadata:
   dependencies:
     "@mapbox/mapbox-gl-draw": "npm:^1.3.0"
     "@mapbox/mapbox-gl-draw-static-mode": "npm:^1.0.1"
+    "@tanstack/react-query": "npm:^5.90.10"
     "@testing-library/jest-dom": "npm:^5.14.1"
     "@testing-library/react": "npm:^13.0.0"
     "@testing-library/user-event": "npm:^13.2.1"

src/context/index.tsx

@@ -13,7 +13,11 @@ type StacApiProviderType = {
   queryClient?: QueryClient;
 };
 
-export function StacApiProvider({ children, apiUrl, options, queryClient }: StacApiProviderType) {
+function StacApiProviderInner({
+  children,
+  apiUrl,
+  options,
+}: Omit<StacApiProviderType, 'queryClient'>) {
   const { stacApi } = useStacApi(apiUrl, options);
   const [collections, setCollections] = useState<CollectionsResponse>();
   const [items, setItems] = useState(new Map<string, Item>());
@@ -48,6 +52,10 @@ export function StacApiProvider({ children, apiUrl, options, queryClient }: Stac
     [addItem, collections, deleteItem, getItem, stacApi]
   );
 
+  return <StacApiContext.Provider value={contextValue}>{children}</StacApiContext.Provider>;
+}
+
+export function StacApiProvider({ children, apiUrl, options, queryClient }: StacApiProviderType) {
   const defaultClient = useMemo(() => new QueryClient(), []);
   const client: QueryClient = queryClient ?? defaultClient;
 
@@ -58,7 +66,9 @@ export function StacApiProvider({ children, apiUrl, options, queryClient }: Stac
 
   return (
     <QueryClientProvider client={client}>
-      <StacApiContext.Provider value={contextValue}>{children}</StacApiContext.Provider>
+      <StacApiProviderInner apiUrl={apiUrl} options={options}>
+        {children}
+      </StacApiProviderInner>
     </QueryClientProvider>
   );
 }

vite.config.ts

@@ -12,7 +12,7 @@ export default defineConfig({
     },
     sourcemap: true,
     rollupOptions: {
-      external: ['react', 'react-dom'],
+      external: ['react', 'react-dom', '@tanstack/react-query'],
     },
   },
   plugins: [