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

package/README.md

@@ -24,6 +24,22 @@ export function App() {
 }
 ```
 
+## MapLibre 6 worker
+
+With MapLibre GL JS 6, configure the application-owned worker once before mounting an interactive
+map. The worker URL must come from the same `maplibre-gl` package installed by the application.
+
+```tsx
+import {configureTileflowMapLibre} from '@tileflow/react';
+import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url';
+
+configureTileflowMapLibre({workerUrl});
+```
+
+This is the Vite setup. Call it in the client entry before rendering `Map`; `mode="image"` remains
+MapLibre-free. MapLibre GL JS 6.4.1-6.x is supported. Use the `@tileflow/next` or
+`@tileflow/webpack` README for their worker-delivery recipes.
+
 ## Annotations, tooltips, and popups
 
 Use `annotations` for small application-owned marker sets. Annotation data is serializable, while
@@ -278,8 +294,8 @@ application scenes and requires exactly one target.
 
 ## Compatibility
 
-The supported peer window is React 18-19 and MapLibre GL JS 5-6. Compatibility smoke tests install
-the exact lower bound and the first release of every accepted major from packed Tileflow tarballs,
+The supported peer window is React 18-19 and MapLibre GL JS 6.4.1-6.x. Compatibility smoke tests
+install the exact lower bound and the selected current release from packed Tileflow tarballs,
 typecheck a consumer, and render the image/SSR path while rejecting any MapLibre import. Future
 majors stay outside the peer range until that matrix passes.
 

package/dist/index.d.ts

@@ -69,4 +69,10 @@ type MapImageProps = MapSharedProps & {
 type MapProps<TAnnotation extends TileflowAnnotation = TileflowAnnotation> = (MapInteractiveProps<TAnnotation> | MapImageProps) & TileflowMapStyleSourceProps;
 declare function Map<TAnnotation extends TileflowAnnotation = TileflowAnnotation>(props: MapProps<TAnnotation>): react.JSX.Element;
 
-export { Map, type MapProps, type TileflowAnnotationRenderer, type TileflowInteractionRenderer, type TileflowMapOptions, type TileflowMapSource };
+type TileflowMapLibreConfiguration = Readonly<{
+    workerUrl: string;
+}>;
+/** Configure the application-owned worker before mounting an interactive Tileflow map. */
+declare function configureTileflowMapLibre(configuration: TileflowMapLibreConfiguration): void;
+
+export { Map, type MapProps, type TileflowAnnotationRenderer, type TileflowInteractionRenderer, type TileflowMapLibreConfiguration, type TileflowMapOptions, type TileflowMapSource, configureTileflowMapLibre };

package/dist/index.js

@@ -189,8 +189,21 @@ function assertTileflowMapStyleInputs(input) {
 
 // src/maplibre.ts
 var mapLibrePromise;
+var mapLibre;
+var workerUrl;
+function configureTileflowMapLibre(configuration) {
+  const nextWorkerUrl = configuration.workerUrl;
+  if (typeof nextWorkerUrl !== "string" || nextWorkerUrl.trim().length === 0) {
+    throw new TypeError("Tileflow MapLibre workerUrl must be a non-empty string.");
+  }
+  if (workerUrl !== void 0 && workerUrl !== nextWorkerUrl) {
+    throw new Error("Tileflow MapLibre workerUrl is already configured.");
+  }
+  workerUrl = nextWorkerUrl;
+  mapLibre?.setWorkerUrl(nextWorkerUrl);
+}
 function loadTileflowMapLibre() {
-  mapLibrePromise ??= import("maplibre-gl").then(resolveMapLibreModule).catch((error) => {
+  mapLibrePromise ??= import("maplibre-gl").then(resolveMapLibreModule).then(configureTileflowMapLibreModule).catch((error) => {
     mapLibrePromise = void 0;
     throw error;
   });
@@ -200,6 +213,11 @@ function resolveMapLibreModule(module) {
   const defaultExport = module.default;
   return defaultExport ?? module;
 }
+function configureTileflowMapLibreModule(maplibregl) {
+  if (workerUrl !== void 0) maplibregl.setWorkerUrl(workerUrl);
+  mapLibre = maplibregl;
+  return maplibregl;
+}
 
 // src/map.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -1218,10 +1236,11 @@ function wrapMapLibrePositioned(positioned) {
   };
 }
 function createTileflowMapLibrePoiMap(map) {
+  const poiMap = map;
   return {
     getStyle: () => map.getStyle(),
     on(event, listener) {
-      return map.on(event, listener);
+      return poiMap.on(event, listener);
     },
     queryRenderedFeatures(point, options) {
       return map.queryRenderedFeatures(point, {
@@ -1298,5 +1317,6 @@ function isPlainObject(value) {
   return prototype === Object.prototype || prototype === null;
 }
 export {
-  Map2 as Map
+  Map2 as Map,
+  configureTileflowMapLibre
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/react",
-  "version": "0.1.0-alpha.22",
+  "version": "0.1.0-alpha.24",
   "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,19 +43,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@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.22 <0.1.0-beta.0"
+    "@tileflow/core": ">=0.1.0-alpha.24 <0.1.0-beta.0",
+    "@tileflow/interactions": ">=0.1.0-alpha.3 <0.1.0-beta.0",
+    "@tileflow/static": ">=0.1.0-alpha.24 <0.1.0-beta.0"
   },
   "peerDependencies": {
-    "maplibre-gl": ">=5 <7",
+    "maplibre-gl": ">=6.4.1 <7",
     "react": ">=18 <20",
     "react-dom": ">=18 <20"
   },
   "devDependencies": {
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "maplibre-gl": "^5.24.0",
+    "maplibre-gl": "6.9.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.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.