@tileflow/react 0.1.0-alpha.33 → 0.1.0-alpha.35

package/README.md

@@ -55,8 +55,8 @@ hosted manifest.
 In a Vite application's client entry, add this before mounting React:
 
 ```ts
-import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url';
 import {configureTileflowMapLibre} from '@tileflow/react';
+import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url';
 
 configureTileflowMapLibre({workerUrl});
 ```
@@ -73,8 +73,8 @@ Import MapLibre's CSS once in the application. After the worker and assets are r
 <!-- docs:check -->
 
 ```tsx
-import 'maplibre-gl/dist/maplibre-gl.css';
 import {Map} from '@tileflow/react';
+import 'maplibre-gl/dist/maplibre-gl.css';
 
 export function App() {
   return (
@@ -105,7 +105,8 @@ Maps without this capability ignore the option; omitting it keeps the selected t
 Changing it uses the existing theme transition. `themeBlend` takes precedence. See the
 [authoring contract](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/README.md#style-with-themes-and-semantic-modules).
 
-`themeTransition={{duration: 450}}` cross-fades theme changes over that many milliseconds.
+Theme and `timeOfDay` changes cross-fade over 450 ms by default, respecting reduced motion.
+`themeTransition={{duration: 700}}` customizes the duration; use `duration: 0` for an immediate change.
 `themeBlend={{themes: ['night', 'dusk', 'day'], position}}` shows a continuous blend of the map's
 themes instead of `theme`: position 0 is the first theme and 1.5 is halfway from the second to the
 third. Moving the position updates the map at once. See
@@ -127,6 +128,9 @@ take priority over `mapOptions`, then the manifest view, then shared defaults. `
 a Tileflow map through its manifest; it has no renderer discriminator or direct-style mode.
 Tileflow's styles are validated when they are compiled, so `validateStyle` defaults to `false`; pass
 `true` to validate them again in the browser.
+The map canvas is multisampled by default (`canvasContextAttributes.antialias` is `true`) so the
+thin edges of 3D models stay continuous; other context attributes you pass are kept, and
+`canvasContextAttributes: {antialias: false}` trades that smoothing for lower GPU cost.
 The obsolete source fields `kind` and `style` are rejected. For a completely unmanaged map, use
 `maplibre-gl` directly rather than a Tileflow component.
 
@@ -139,9 +143,9 @@ and memoize the values; each new object replaces the previous ones, and `null` c
 <!-- docs:check -->
 
 ```tsx
+import {Map, useBoundaryFeatureState} from '@tileflow/react';
 import {useMemo, useState} from 'react';
 import type {Map as MapLibreMap} from 'maplibre-gl';
-import {Map, useBoundaryFeatureState} from '@tileflow/react';
 
 export function Unemployment({rates}: {rates: {ine: string; rate: number}[]}) {
   const [map, setMap] = useState<MapLibreMap | null>(null);
@@ -177,9 +181,9 @@ into hosts managed by the interaction runtime:
 <!-- docs:check -->
 
 ```tsx
+import {Map} from '@tileflow/react';
 import {useState} from 'react';
 import type {TileflowAnnotation, TileflowInteractionState} from '@tileflow/interactions';
-import {Map} from '@tileflow/react';
 
 type Property = {price: number; title: string};
 
@@ -257,8 +261,8 @@ Tileflow credentials on that server, not in React props or a browser bundle.
 <!-- docs:check -->
 
 ```tsx
-import {useState} from 'react';
 import {StaticMap} from '@tileflow/react/static';
+import {useState} from 'react';
 import type {StaticMapAttributionEntry} from '@tileflow/static/client';
 
 export function StaticPreview({idempotencyKey}: {idempotencyKey: string}) {

package/dist/index.js

@@ -41,8 +41,10 @@ import { createPortal } from "react-dom";
 import {
   attachTileflowAtmosphere,
   attachTileflowFairUseNotice,
+  attachTileflowLabelPlacement,
   attachTileflowMap3D,
   attachTileflowMapLifecycle,
+  attachTileflowNauticalLights,
   attachTileflowNotices,
   createTileflowSessionStarter,
   createTileflowThemeController,
@@ -52,7 +54,9 @@ import {
   registerTileflowContourProtocol,
   registerTileflowPmtilesProtocol,
   registerTileflowWorldRequestBridge,
-  subscribeTileflowSystemColorScheme
+  subscribeTileflowSystemColorScheme,
+  tileflowCanvasContextAttributes,
+  tileflowMaxPitch
 } from "@tileflow/core/browser";
 import { normalizeTileflowCaptureId } from "@tileflow/core/capture";
 import {
@@ -805,6 +809,9 @@ function Map2(props) {
       });
       const map = new maplibregl.Map({
         ...stableMapOptions,
+        canvasContextAttributes: tileflowCanvasContextAttributes(
+          stableMapOptions?.canvasContextAttributes
+        ),
         container,
         style: initialRuntimeStyle.style,
         bearing: bearingRef.current,
@@ -817,6 +824,7 @@ function Map2(props) {
         },
         // Tileflow's compiled styles are validated when they are built.
         validateStyle: stableMapOptions?.validateStyle ?? false,
+        maxPitch: stableMapOptions?.maxPitch ?? tileflowMaxPitch,
         transformRequest
       });
       mapRef.current = map;
@@ -824,6 +832,8 @@ function Map2(props) {
       registerCleanup(() => map.remove());
       registerCleanup(attachTileflowAtmosphere(map));
       registerCleanup(attachTileflowNotices(map));
+      registerCleanup(attachTileflowNauticalLights(map));
+      registerCleanup(attachTileflowLabelPlacement(map));
       const themeController = initialRuntimeStyle.theme === void 0 ? void 0 : createTileflowThemeController({
         initial: initialRuntimeStyle,
         map,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/react",
-  "version": "0.1.0-alpha.33",
+  "version": "0.1.0-alpha.35",
   "license": "Apache-2.0",
   "description": "React components for rendering Tileflow maps with MapLibre.",
   "type": "module",
@@ -43,7 +43,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.38 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.40 <0.1.0-beta.0",
     "@tileflow/interactions": ">=0.1.0-alpha.6 <0.1.0-beta.0",
     "@tileflow/static": ">=0.1.0-alpha.28 <0.1.0-beta.0"
   },