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

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.23",
   "license": "Apache-2.0",
   "description": "React components for rendering Tileflow maps with MapLibre.",
   "type": "module",
@@ -25,10 +25,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "LICENSE",
-    "NOTICE",
-    "GENERATED_OUTPUT_LICENSE.md",
-    "TRADEMARKS.md"
+    "LICENSE"
   ],
   "exports": {
     ".": {
@@ -46,9 +43,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.22 <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/core": ">=0.1.0-alpha.24 <0.1.0-beta.0",
+    "@tileflow/interactions": ">=0.1.0-alpha.2 <0.1.0-beta.0",
+    "@tileflow/static": ">=0.1.0-alpha.23 <0.1.0-beta.0"
   },
   "peerDependencies": {
     "maplibre-gl": ">=5 <7",

package/GENERATED_OUTPUT_LICENSE.md

@@ -1,21 +0,0 @@
-# Tileflow generated-output grant
-
-In addition to the rights granted by the Apache License, Version 2.0, Tileflow.dev contributors
-grant recipients a perpetual, worldwide, non-exclusive, no-charge, royalty-free right to use,
-reproduce, modify, display, perform, distribute, sublicense, and commercialize the Tileflow-owned
-parts of output generated by this SDK.
-
-Covered output includes compiled map styles, manifests, receipts, sprites, glyph artifacts, static
-render descriptions, and other build artifacts produced from Tileflow maps or application maps.
-Original Tileflow map definitions, icons, and patterns distributed by `@tileflow/maps` may likewise
-be used, modified, embedded, deployed, and redistributed as part of personal or commercial maps and
-applications.
-
-This grant does not relicense third-party software, fonts, icons, map data, datasets, imagery, or
-other input material. Their licenses, attribution requirements, notices, and use restrictions
-continue to apply to the relevant source and generated output. You are responsible for having the
-rights necessary to process and distribute your own inputs.
-
-This grant does not provide access to Tileflow hosted services or grant rights in Tileflow names,
-logos, or marks. The SDK and generated output are provided without warranties or conditions beyond
-those required by applicable law.

package/NOTICE

@@ -1,9 +0,0 @@
-Tileflow SDK
-Copyright 2026 Tileflow.dev contributors
-
-This product includes software and original map artwork developed by Tileflow.dev contributors.
-
-Third-party materials distributed with a package remain subject to their own license and notice
-files. See THIRD_PARTY_NOTICES.md and asset-adjacent license files where present.
-
-The Tileflow names and marks are not licensed under the Apache License 2.0. See TRADEMARKS.md.

package/TRADEMARKS.md

@@ -1,10 +0,0 @@
-# Tileflow trademarks
-
-The Apache License, Version 2.0, and the Tileflow generated-output grant do not grant permission to
-use the Tileflow name, `tileflow.dev`, logos, service marks, product names, or other Tileflow brand
-features except for reasonable and customary use that truthfully describes the origin of the SDK or
-compatibility with Tileflow, and for reproducing required notices.
-
-You may not use Tileflow brand features in a way that suggests sponsorship, endorsement, or an
-official Tileflow product when none exists. Third-party names and marks remain the property of their
-respective owners.