@tileflow/react-native 0.1.0-alpha.4 → 0.1.0-alpha.6

package/README.md

@@ -93,15 +93,10 @@ 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: a snapshot of the drawn map covers it, follows the camera and fades out once the new theme is drawn. `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:
+Theme and `timeOfDay` changes cross-fade over 450 ms by default: a snapshot of the drawn map covers it, follows the camera and fades out once the new theme is drawn. Use `themeTransition={{duration: 700}}` to customize the duration, or `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:
 
 ```tsx
-<Map
-  source={source}
-  themeTransition={{duration: 450}}
-  themeBlend={{themes: ['night', 'dusk', 'day'], position}}
-  style={{flex: 1}}
-/>
+<Map source={source} themeBlend={{themes: ['night', 'dusk', 'day'], position}} style={{flex: 1}} />
 ```
 
 The first blend of a set of themes prepares every theme's style and replaces the native style once; moving `position` later changes the map without loading. Removing `themeBlend` returns to `theme`. Both keep the same native Map, context and session, and `ready` events wait for the fade. The device's reduce-motion setting changes at once. See [theme transitions and blends](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/theme-transitions-and-blends.md#react-native) for what follows the position on native maps.
@@ -226,6 +221,11 @@ annotation or POI targets but no popup, callout, tooltip, sheet, panel or modal
 The mounted component does not add location, selection-presentation UI, offline product APIs, an
 Expo config plugin, CLI behavior, deployment or publication. The package remains pre-release.
 
+Native maps do not draw a map's 3D scene. Core's 3D buildings, Tileflow landmarks, Team building
+models, 3D trees and street lights are WebGL layers for MapLibre GL JS, which the web `Map`
+components mount by default; a native map shows the style's 2D layers and the vegetation fallback
+the map declares.
+
 Source and tests describe contracts; they do not establish that a native build, simulator/device run, Hosted service, app-store submission or package publication succeeded. Qualify the exact source revision in the intended host before relying on it.
 
 ## Foreground location is application-owned

package/dist/{contract-Bp-Im7tj.d.ts → contract-By3URNxS.d.ts}

@@ -28,12 +28,12 @@ type MapView = TileflowNativeInitialView;
 /** Portable composition inputs, independent from source acquisition. */
 type MapInitialViewInputs = TileflowNativeInitialViewOptions;
 /**
- * How a theme change appears. With a `duration`, a snapshot of the current frame covers the map,
+ * How a theme change appears. By default, a snapshot of the current frame covers the map,
  * follows the camera, and fades out once the new theme is drawn. The device's reduce-motion
  * setting changes at once.
  */
 type MapThemeTransition = Readonly<{
-    /** Cross-fade length in milliseconds, from 0 (the default, an immediate change) to 5000. */
+    /** Cross-fade length in milliseconds, from 0 (immediate) to 5000. Defaults to 450. */
     duration?: number;
 }>;
 /**

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { ReactElement } from 'react';
 import { TileflowAnnotation } from '@tileflow/interactions';
 export { TileflowAnnotation, TileflowInteractionBinding, TileflowInteractionCoordinate, TileflowInteractionDiagnostic, TileflowPoiCategory, TileflowResolvedAnnotationTarget, TileflowResolvedPoiFeatureTarget } from '@tileflow/interactions';
-import { d as MapProps } from './contract-Bp-Im7tj.js';
-export { e as MapBaseProps, c as MapCameraProps, f as MapColorScheme, g as MapErrorEvent, h as MapEventHandlers, b as MapInitialViewInputs, i as MapInteractionEvent, j as MapInteractionProps, k as MapLoadEvent, l as MapMarkerRenderContext, m as MapMarkerRenderer, n as MapOptions, o as MapPresentationProps, p as MapReadinessChangeEvent, q as MapRef, r as MapSelection, s as MapSource, t as MapSourceError, u as MapSourceProps, v as MapSourceState, w as MapTheme, x as MapThemeBlend, y as MapThemeChangeEvent, z as MapThemeSelection, A as MapThemeTransition, M as MapView, a as MapViewChangeEvent } from './contract-Bp-Im7tj.js';
+import { d as MapProps } from './contract-By3URNxS.js';
+export { e as MapBaseProps, c as MapCameraProps, f as MapColorScheme, g as MapErrorEvent, h as MapEventHandlers, b as MapInitialViewInputs, i as MapInteractionEvent, j as MapInteractionProps, k as MapLoadEvent, l as MapMarkerRenderContext, m as MapMarkerRenderer, n as MapOptions, o as MapPresentationProps, p as MapReadinessChangeEvent, q as MapRef, r as MapSelection, s as MapSource, t as MapSourceError, u as MapSourceProps, v as MapSourceState, w as MapTheme, x as MapThemeBlend, y as MapThemeChangeEvent, z as MapThemeSelection, A as MapThemeTransition, M as MapView, a as MapViewChangeEvent } from './contract-By3URNxS.js';
 import '@maplibre/maplibre-react-native';
 import 'react-native';
 import '@tileflow/core/native';

package/dist/index.js

@@ -5466,6 +5466,7 @@ function projectMapSourceState(state) {
 // src/theme-motion-input.ts
 import { validateTileflowThemeBlendSelection } from "@tileflow/core/native";
 var maximumTransitionMs = 5e3;
+var defaultTransitionMs = 450;
 function own(value, keys) {
   const prototype = Object.getPrototypeOf(value);
   if (Array.isArray(value) || prototype !== Object.prototype && prototype !== null)
@@ -5480,9 +5481,9 @@ function own(value, keys) {
   return result;
 }
 function snapshotThemeTransition(value) {
-  if (value === void 0) return 0;
+  if (value === void 0) return defaultTransitionMs;
   if (!value || typeof value !== "object") throw new NativePreparationError();
-  const { duration = 0 } = own(value, ["duration"]);
+  const { duration = defaultTransitionMs } = own(value, ["duration"]);
   if (typeof duration !== "number" || !Number.isFinite(duration) || duration < 0 || duration > maximumTransitionMs)
     throw new NativePreparationError();
   return Math.round(duration);

package/dist/internal/camera.d.ts

@@ -1,4 +1,4 @@
-import { M as MapView, a as MapViewChangeEvent, b as MapInitialViewInputs, c as MapCameraProps } from '../contract-Bp-Im7tj.js';
+import { M as MapView, a as MapViewChangeEvent, b as MapInitialViewInputs, c as MapCameraProps } from '../contract-By3URNxS.js';
 import '@maplibre/maplibre-react-native';
 import 'react';
 import 'react-native';

package/dist/internal/initial-view.d.ts

@@ -1,4 +1,4 @@
-import { b as MapInitialViewInputs, M as MapView } from '../contract-Bp-Im7tj.js';
+import { b as MapInitialViewInputs, M as MapView } from '../contract-By3URNxS.js';
 import '@maplibre/maplibre-react-native';
 import 'react';
 import 'react-native';

package/dist/internal/native-appearance.d.ts

@@ -1,4 +1,4 @@
-import { z as MapThemeSelection, f as MapColorScheme } from '../contract-Bp-Im7tj.js';
+import { z as MapThemeSelection, f as MapColorScheme } from '../contract-By3URNxS.js';
 import '@maplibre/maplibre-react-native';
 import 'react';
 import 'react-native';

package/dist/internal/source-state.d.ts

@@ -1,5 +1,5 @@
 import { TileflowNativeSourceState } from '@tileflow/core/native';
-import { v as MapSourceState } from '../contract-Bp-Im7tj.js';
+import { v as MapSourceState } from '../contract-By3URNxS.js';
 import '@maplibre/maplibre-react-native';
 import 'react';
 import 'react-native';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/react-native",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.6",
   "license": "Apache-2.0",
   "description": "Tileflow maps, camera control and semantic interactions for React Native.",
   "type": "module",
@@ -36,8 +36,8 @@
     }
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.35 <0.1.0-beta.0",
-    "@tileflow/interactions": ">=0.1.0-alpha.5 <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"
   },
   "peerDependencies": {
     "@maplibre/maplibre-react-native": "11.5.0",