@tileflow/react 0.1.0-alpha.28 → 0.1.0-alpha.29

package/README.md

@@ -208,7 +208,7 @@ Tileflow credentials on that server, not in React props or a browser bundle.
 ```tsx
 import {useState} from 'react';
 import {StaticMap} from '@tileflow/react/static';
-import type {StaticMapAttributionEntry} from '@tileflow/static';
+import type {StaticMapAttributionEntry} from '@tileflow/static/client';
 
 export function StaticPreview({idempotencyKey}: {idempotencyKey: string}) {
   const [entries, setEntries] = useState<readonly StaticMapAttributionEntry[]>([]);

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { CSSProperties, ImgHTMLAttributes, ReactNode } from 'react';
 import { MapOptions, Map as Map$1 } from 'maplibre-gl';
-import { TileflowThemeTransitionOptions, TileflowThemeTransition } from '@tileflow/core/browser';
-import { TileflowRuntimeSource, TileflowThemeSelection, TileflowThemeBlendSelection, TileflowAnalytics } from '@tileflow/core/runtime';
+import { TileflowBrowserThemeBlendSelection, TileflowThemeTransitionOptions, TileflowThemeTransition } from '@tileflow/core/browser';
+import { TileflowRuntimeSource, TileflowThemeSelection, TileflowAnalytics } from '@tileflow/core/runtime';
 import { TileflowAnnotation, TileflowInteractionState, TileflowAnnotationViewContext, TileflowInteractionBinding, TileflowInteractionViewContext, TileflowInteractionDiagnostic, TileflowInteractionEvent } from '@tileflow/interactions';
 
 type TileflowMapStyleSourceProps = {
@@ -10,9 +10,10 @@ type TileflowMapStyleSourceProps = {
     theme?: TileflowThemeSelection;
     /**
      * Shows a continuous blend of the map's themes instead of `theme`. Moving `position` changes the
-     * map at once; changing `themes` prepares a new blend.
+     * map at once; changing `themes` prepares a new blend. `hold` keeps labels, icons, and mixed
+     * artwork back during a camera move; clearing it brings them in at once.
      */
-    themeBlend?: TileflowThemeBlendSelection;
+    themeBlend?: TileflowBrowserThemeBlendSelection;
     /** Cross-fades theme changes, including entering and leaving a blend. */
     themeTransition?: TileflowThemeTransitionOptions;
 };

package/dist/index.js

@@ -167,9 +167,11 @@ function prepareTileflowReactInteractionState(interactionState, defaultInteracti
 }
 
 // src/map-style-inputs.ts
+import {
+  validateTileflowBrowserThemeBlendSelection
+} from "@tileflow/core/browser";
 import {
   validateTileflowRuntimeSource,
-  validateTileflowThemeBlendSelection,
   validateTileflowThemeSelection
 } from "@tileflow/core/runtime";
 function validateTileflowMapStyleInputs(input) {
@@ -178,9 +180,9 @@ function validateTileflowMapStyleInputs(input) {
   if (input.theme !== void 0 && !validateTileflowThemeSelection(input.theme)) {
     return { error: 'theme must be a concrete portable theme name or "system"', ok: false };
   }
-  if (input.themeBlend !== void 0 && !validateTileflowThemeBlendSelection(input.themeBlend)) {
+  if (input.themeBlend !== void 0 && !validateTileflowBrowserThemeBlendSelection(input.themeBlend)) {
     return {
-      error: "themeBlend must name two to eight concrete themes and a position from 0 to themes.length - 1",
+      error: "themeBlend must name two to eight concrete themes, a position from 0 to themes.length - 1, and an optional boolean hold",
       ok: false
     };
   }
@@ -350,6 +352,7 @@ function Map2(props) {
   const manifestMap = currentManifestResolution.state === "ready" ? currentManifestResolution.map : null;
   const themeBlendKey = themeBlend ? JSON.stringify(themeBlend.themes) : void 0;
   const themeBlendPosition = themeBlend?.position;
+  const themeBlendHold = themeBlend?.hold === true;
   const blendThemeName = themeBlend ? nearestTileflowBlendTheme(themeBlend) : void 0;
   const themeResolution = useMemo(() => {
     const selection = blendThemeName ?? theme;
@@ -524,7 +527,7 @@ function Map2(props) {
     }
   }, [isImageMode, manifestMap, runtimeSource, themeBlendKey]);
   const blendRequestRef = useRef(null);
-  blendRequestRef.current = blendStyles && themeBlendPosition !== void 0 ? { position: themeBlendPosition, themes: blendStyles } : null;
+  blendRequestRef.current = blendStyles && themeBlendPosition !== void 0 ? { hold: themeBlendHold, position: themeBlendPosition, themes: blendStyles } : null;
   const themeTransitionRef = useRef(themeTransition);
   themeTransitionRef.current = themeTransition;
   const runtimeMapIdentity = `${manifestUrl}\0${runtimeSource.map}`;
@@ -745,8 +748,6 @@ function Map2(props) {
       });
       registerCleanup(() => worldRequestBridge.dispose());
       const transformRequest = createTileflowTransformRequest({
-        always: true,
-        asyncAnalyticsTiming: "resolution",
         getAnalytics: () => resolvedAnalyticsRef.current,
         sessionController: session,
         sessionId: session.sessionId,
@@ -1017,14 +1018,14 @@ function Map2(props) {
     if (!controller || !blendStyles || themeBlendPosition === void 0) return;
     if (runtimeStyle) setActiveRuntimeResource(runtimeStyle);
     void controller.setBlend(
-      { position: themeBlendPosition, themes: blendStyles },
+      { hold: themeBlendHold, position: themeBlendPosition, themes: blendStyles },
       { transition: themeTransitionRef.current }
     ).then((result) => {
       if (result.status === "failed") {
         console.error("Failed to blend the Tileflow map themes", result.error);
       }
     });
-  }, [blendStyles, runtimeStyle, themeBlendPosition]);
+  }, [blendStyles, runtimeStyle, themeBlendHold, themeBlendPosition]);
   useLayoutEffect(() => {
     if (!isImageMode) return;
     readinessRunRef.current += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/react",
-  "version": "0.1.0-alpha.28",
+  "version": "0.1.0-alpha.29",
   "license": "Apache-2.0",
   "description": "React components for rendering Tileflow maps with MapLibre.",
   "type": "module",
@@ -43,9 +43,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.30 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.32 <0.1.0-beta.0",
     "@tileflow/interactions": ">=0.1.0-alpha.4 <0.1.0-beta.0",
-    "@tileflow/static": ">=0.1.0-alpha.27 <0.1.0-beta.0"
+    "@tileflow/static": ">=0.1.0-alpha.28 <0.1.0-beta.0"
   },
   "peerDependencies": {
     "maplibre-gl": ">=6.4.1 <7",
@@ -53,11 +53,11 @@
     "react-dom": ">=18 <20"
   },
   "devDependencies": {
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "maplibre-gl": "6.9.0",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7"
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "maplibre-gl": "6.13.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
   },
   "scripts": {
     "build": "tsup",