@tileflow/react 0.1.0-alpha.21 → 0.1.0-alpha.22

package/README.md

@@ -230,9 +230,13 @@ export function Preview() {
     <StaticMap
       map="madrid"
       camera={{type: 'center', center: [-3.7038, 40.4168], zoom: 12}}
+      attribution={{mode: 'external'}}
       size={{width: 1200, height: 800}}
       createUrl="/api/static-maps"
       idempotencyKey={idempotencyKey}
+      onReady={(result) => {
+        if (result.resultVersion === 2) showAttribution(result.attribution.entries);
+      }}
     />
   );
 }
@@ -243,6 +247,11 @@ reuse it across retries and remounts. Concurrent React consumers share work only
 normalized scene, and idempotency key all identify the same operation; unmounting the final
 consumer aborts its in-flight request.
 
+`StaticMap` forwards `attribution` as part of the normalized scene and request identity. Omission
+uses embedded automatic placement. With `mode: 'external'`, the component still renders the image,
+but the application must render every structured `onReady` attribution entry beside it. Existing
+`imageUrl` mode has no operation result and cannot infer attribution from an immutable image URL.
+
 Hosted interactive maps automatically preflight a short-lived commercial session grant before
 eligible resources. Setting `analytics={{enabled: false}}` disables the optional beacon only; it
 does not remove hosted authorization or override a user `mapOptions.transformRequest` callback.

package/dist/static.d.ts

@@ -26,6 +26,6 @@ type StaticMapCreateProps = {
     imageUrl?: never;
 };
 type StaticMapProps = StaticMapBaseProps & (StaticMapCreateProps | StaticMapImageProps);
-declare function StaticMap({ alt, camera, className, captureId, createUrl, imageStyle, imageUrl, idempotencyKey, keepPreviousImage, loading, map, onError, onImageLoad, onReady, overlays, size, style, theme, }: StaticMapProps): react.JSX.Element;
+declare function StaticMap({ alt, attribution, camera, className, captureId, createUrl, format, imageStyle, imageUrl, idempotencyKey, keepPreviousImage, loading, map, onError, onImageLoad, onReady, overlays, size, style, theme, }: StaticMapProps): react.JSX.Element;
 
 export { StaticMap, type StaticMapProps };

package/dist/static.js

@@ -107,10 +107,12 @@ function abortReason(signal) {
 import { jsx } from "react/jsx-runtime";
 function StaticMap({
   alt = "",
+  attribution,
   camera,
   className,
   captureId,
   createUrl,
+  format,
   imageStyle,
   imageUrl,
   idempotencyKey,
@@ -135,10 +137,10 @@ function StaticMap({
   const resolvedCaptureId = normalizeTileflowCaptureId(captureId);
   const onErrorRef = useRef(onError);
   const onReadyRef = useRef(onReady);
-  const sceneInputKey = stableStringify2({ camera, map, overlays, size, theme });
+  const sceneInputKey = stableStringify2({ attribution, camera, format, map, overlays, size, theme });
   const preparedSceneCandidate = useMemo(
-    () => prepareSceneRequest({ camera, map, overlays, size, theme }),
-    [camera, map, overlays, size, theme]
+    () => prepareSceneRequest({ attribution, camera, format, map, overlays, size, theme }),
+    [attribution, camera, format, map, overlays, size, theme]
   );
   const preparedScene = useStablePreparedSceneRequest(preparedSceneCandidate);
   const sceneKey = preparedScene.ok ? preparedScene.request.sceneKey : `invalid:${sceneInputKey}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/react",
-  "version": "0.1.0-alpha.21",
+  "version": "0.1.0-alpha.22",
   "license": "Apache-2.0",
   "description": "React components for rendering Tileflow maps with MapLibre.",
   "type": "module",
@@ -46,9 +46,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.22 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.23 <0.1.0-beta.0",
     "@tileflow/interactions": ">=0.1.0-alpha.1 <0.1.0-beta.0",
-    "@tileflow/static": ">=0.1.0-alpha.18 <0.1.0-beta.0"
+    "@tileflow/static": ">=0.1.0-alpha.22 <0.1.0-beta.0"
   },
   "peerDependencies": {
     "maplibre-gl": ">=5 <7",