@tileflow/react-native 0.1.0-alpha.3 → 0.1.0-alpha.5

package/README.md

@@ -2,7 +2,7 @@
 
 `@tileflow/react-native` provides a Tileflow `Map` backed by MapLibre Native on iOS and Android. It is pre-release. The first alpha release requires the bootstrap and Trusted Publisher checks in the [publishing guide](https://github.com/tileflow/tileflow-sdk/blob/main/PUBLISHING.md).
 
-The package targets exactly React 19.2.0, React Native 0.83.10 and `@maplibre/maplibre-react-native` 11.3.10, with MapLibre Native Android 13.2.0 and iOS 6.26.0 through the pinned integration below. Expo consumers use Expo 55.0.31 with a native development build; Expo Go does not contain the required native modules.
+The package targets exactly React 19.2.0, React Native 0.83.10 and `@maplibre/maplibre-react-native` 11.5.0, with MapLibre Native Android 13.6.1 and iOS 6.31.0 through the pinned integration below. Expo consumers use Expo 55.0.31 with a native development build; Expo Go does not contain the required native modules.
 
 > Related packages and guides: [documentation index](https://raw.githubusercontent.com/tileflow/tileflow-sdk/main/llms.txt).
 
@@ -11,7 +11,7 @@ The package targets exactly React 19.2.0, React Native 0.83.10 and `@maplibre/ma
 Start with an Expo development build or a bare React Native application matching those peers. Once the first alpha is available, install the package and its direct dependencies:
 
 ```sh
-npm install --save-exact @tileflow/react-native@alpha @tileflow/core@alpha @tileflow/interactions@alpha @maplibre/maplibre-react-native@11.3.10
+npm install --save-exact @tileflow/react-native@alpha @tileflow/core@alpha @tileflow/interactions@alpha @maplibre/maplibre-react-native@11.5.0
 ```
 
 Keep the lockfile. Complete the [native integration](#native-integration) before building the application. Source on `main` can precede npm; installation or local checks do not establish Hosted availability or physical-device acceptance.
@@ -87,6 +87,12 @@ and protected delivery still require HTTPS.
 
 ## Theme transitions and blends
 
+Add `timeOfDay="dusk"` beside `theme` to select a map's optional `day`, `dawn`, `dusk`, or
+`night` preset. For Streets, `theme="light"` with this preset selects the existing `dusk` palette.
+Maps without this capability ignore the option; omitting it keeps the selected theme unchanged.
+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:
 
 ```tsx
@@ -174,7 +180,7 @@ The public lifecycle surface remains:
 
 ## Native integration
 
-Autolinking registers the private Android/iOS modules used by the mounted lifecycle. Android depends on the exact MapLibre React Native project and MapLibre Native 13.2.0. iOS uses the existing MapLibre React Native CocoaPod plus the exact MapLibre Native 6.26.0 Swift Package Manager product.
+Autolinking registers the private Android/iOS modules used by the mounted lifecycle. Android depends on the exact MapLibre React Native project and MapLibre Native 13.6.1. iOS uses the existing MapLibre React Native CocoaPod plus the exact MapLibre Native 6.31.0 Swift Package Manager product.
 
 For the iOS post-install integration, retain the host's normal React Native/MapLibre setup and then call:
 
@@ -220,6 +226,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/TileflowNativeAdmission.podspec

@@ -18,7 +18,7 @@ Pod::Spec.new do |s|
 	s.frameworks = 'Foundation', 'UIKit'
 	s.libraries = 'c++'
 	s.dependency 'React-Core', '0.83.10'
-	s.dependency 'MapLibreReactNative', '11.3.10'
+	s.dependency 'MapLibreReactNative', '11.5.0'
 	# Surface integration consumes only the pinned peer's private native view/camera headers.
 	# No Tileflow native header is promoted to a public CocoaPods header.
 	s.pod_target_xcconfig = {

package/android/build.gradle

@@ -6,9 +6,9 @@ if (agpMajor < 9 || (agpMajor == 9 && !providers.gradleProperty('android.builtIn
 	apply plugin: 'org.jetbrains.kotlin.android'
 }
 
-def nativeVersion = rootProject.ext.has('org.maplibre.reactnative.nativeVersion') ? rootProject.ext.get('org.maplibre.reactnative.nativeVersion').toString() : '13.2.0'
+def nativeVersion = rootProject.ext.has('org.maplibre.reactnative.nativeVersion') ? rootProject.ext.get('org.maplibre.reactnative.nativeVersion').toString() : '13.6.1'
 def nativeVariant = rootProject.ext.has('org.maplibre.reactnative.nativeVariant') ? rootProject.ext.get('org.maplibre.reactnative.nativeVariant').toString() : 'opengl'
-if (nativeVersion != '13.2.0') throw new GradleException('Tileflow native admission requires MapLibre Native 13.2.0')
+if (nativeVersion != '13.6.1') throw new GradleException('Tileflow native admission requires MapLibre Native 13.6.1')
 
 android {
 	namespace 'dev.tileflow.reactnative'
@@ -35,7 +35,7 @@ repositories {
 dependencies {
 	implementation project(':maplibre_maplibre-react-native')
 	implementation('com.facebook.react:react-android:0.83.10') { version { strictly '0.83.10' } }
-	implementation("org.maplibre.gl:android-sdk-${nativeVariant}:13.2.0") { version { strictly '13.2.0' } }
+	implementation("org.maplibre.gl:android-sdk-${nativeVariant}:13.6.1") { version { strictly '13.6.1' } }
 	implementation('com.squareup.okhttp3:okhttp:4.12.0') { version { strictly '4.12.0' } }
 	testImplementation 'junit:junit:4.13.2'
 	testImplementation 'org.robolectric:robolectric:4.14.1'

package/dist/{contract-Bwl-gB-I.d.ts → contract-Bp-Im7tj.d.ts}

@@ -49,6 +49,7 @@ type MapThemeBlend = Readonly<{
 type MapSourceProps = Readonly<{
     source: MapSource;
     theme?: MapThemeSelection;
+    timeOfDay?: TileflowNativeSourceOptions['timeOfDay'];
     /** Cross-fades theme changes, including entering and leaving a blend. */
     themeTransition?: MapThemeTransition;
     /**

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-Bwl-gB-I.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-Bwl-gB-I.js';
+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 '@maplibre/maplibre-react-native';
 import 'react-native';
 import '@tileflow/core/native';

package/dist/index.js

@@ -253,7 +253,7 @@ function parseManifest(style) {
   if (nativeInteractionField(style, "version") !== 8) throw new Error();
   const metadata = nativeInteractionField(style, "metadata");
   const artifact = snapshotNativeInteractionJson(nativeInteractionField(metadata, "tileflow:interaction-manifest"));
-  if (nativeInteractionField(artifact, "version") !== 2) throw new Error();
+  if (nativeInteractionField(artifact, "version") !== 3) throw new Error();
   const poi = nativeInteractionField(nativeInteractionField(artifact, "domains"), "poi");
   if (nativeInteractionField(poi, "identity") !== "maplibre-feature-id-if-present") throw new Error();
   const hitTesting = nativeInteractionField(poi, "hitTesting");
@@ -296,10 +296,9 @@ function parseManifest(style) {
     const layerId = nativeInteractionField(input, "layerId");
     const source = nativeInteractionField(input, "source");
     const sourceLayer = nativeInteractionField(input, "sourceLayer");
-    const layerCategory = nativeInteractionField(input, "category");
     const kind = nativeInteractionField(input, "representation");
     const priority = nativeInteractionField(input, "priority");
-    if (!name(layerId) || !name(source) || sourceLayer !== void 0 && !name(sourceLayer) || !category(layerCategory) || !representation(kind) || typeof priority !== "number" || !Number.isSafeInteger(priority) || priority < 0 || priority > 1e5 || ids.has(layerId) || nativeInteractionField(input, "anchor") !== "pointer-coordinate")
+    if (!name(layerId) || !name(source) || sourceLayer !== void 0 && !name(sourceLayer) || !representation(kind) || typeof priority !== "number" || !Number.isSafeInteger(priority) || priority < 0 || priority > 1e5 || ids.has(layerId) || nativeInteractionField(input, "anchor") !== "pointer-coordinate")
       throw new Error();
     const actual = physical.get(layerId);
     if (!actual || nativeInteractionField(actual, "source") !== source || nativeInteractionField(actual, "source-layer") !== sourceLayer)
@@ -313,7 +312,6 @@ function parseManifest(style) {
       layerId,
       source,
       ...sourceLayer === void 0 ? {} : { sourceLayer },
-      category: layerCategory,
       representation: kind,
       priority
     });
@@ -367,8 +365,11 @@ function choose(features, manifest, bindings, coordinate2, queried) {
     if (!layer || !allowed2.has(layer.layerId)) continue;
     if (nativeInteractionField(feature, "source") !== layer.source || nativeInteractionField(feature, "sourceLayer") !== layer.sourceLayer)
       throw new Error();
+    const featureProperties = properties(nativeInteractionField(feature, "properties"), manifest.fields);
+    const featureCategory = featureProperties.category;
+    if (!category(featureCategory)) throw new Error();
     const binding = bindings.find(
-      (value) => value.target.kind === "semantic-feature" && value.target.domain === "poi" && (!value.target.categories || value.target.categories.includes(layer.category))
+      (value) => value.target.kind === "semantic-feature" && value.target.domain === "poi" && (!value.target.categories || value.target.categories.includes(featureCategory))
     );
     if (!binding) continue;
     const stable = featureId(nativeInteractionField(feature, "id"));
@@ -378,9 +379,9 @@ function choose(features, manifest, bindings, coordinate2, queried) {
       coordinate: coordinate2,
       bindingId: binding.id,
       feature: {
-        category: layer.category,
+        category: featureCategory,
         ...stable === void 0 ? {} : { id: stable },
-        properties: properties(nativeInteractionField(feature, "properties"), manifest.fields)
+        properties: featureProperties
       }
     });
     const candidate = { layer, renderedIndex, match: Object.freeze({ binding, target }) };
@@ -443,7 +444,7 @@ function createNativePoiAdapter() {
     },
     supports(target) {
       const parsed = manifest;
-      return !!parsed && inspect(lease, generation) === "current" && manifest === parsed && parsed.layers.some((layer) => layer.category === target.feature.category);
+      return !!parsed && inspect(lease, generation) === "current" && manifest === parsed && parsed.layers.length > 0 && category(target.feature.category);
     },
     replaceStyle(next) {
       if (disposed) return emptyDiagnostics;
@@ -499,11 +500,7 @@ function createNativePoiAdapter() {
       if (!owner || !selected) return answer(failure());
       const ownership = inspect(owner, expected);
       if (ownership !== "current") return answer(ownership === "error" ? failure() : stale);
-      const layers = selected.layers.filter(
-        (layer) => bindings.some(
-          (binding) => binding.target.kind === "semantic-feature" && (!binding.target.categories || binding.target.categories.includes(layer.category))
-        )
-      ).map((layer) => layer.layerId);
+      const layers = selected.layers.map((layer) => layer.layerId);
       if (!layers.length) return answer(miss);
       if (!invocationIsLive()) return Promise.resolve(stale);
       const request = Object.freeze({
@@ -849,7 +846,7 @@ function requestedLayers(style, request) {
   const physical = array2(nativeInteractionField(style, "layers"), 4096);
   const sources = nativeInteractionField(style, "sources");
   const artifact = nativeInteractionField(nativeInteractionField(style, "metadata"), "tileflow:interaction-manifest");
-  if (nativeInteractionField(artifact, "version") !== 2) throw new Error();
+  if (nativeInteractionField(artifact, "version") !== 3) throw new Error();
   const semantic = array2(nativeInteractionField(nativeInteractionField(nativeInteractionField(artifact, "domains"), "poi"), "layers"), 256);
   let previous = physical.length;
   return requested.map((id) => {
@@ -3445,7 +3442,9 @@ function snapshotHostedNativeManifestIdentity(source) {
     if (sourceUrl !== expected || finalUrl !== expected) throw new Error();
     const manifest = field(source, "manifest");
     const maps = field(manifest, "maps");
-    if (field(manifest, "version") !== 1 || names(maps, 1)[0] !== name3) throw new Error();
+    const manifestVersion = field(manifest, "version");
+    if (manifestVersion !== 1 && manifestVersion !== 2 || names(maps, 1)[0] !== name3)
+      throw new Error();
     const declared = field(maps, name3);
     if (field(declared, "mapId") !== mapId || field(declared, "usageMode") !== "session")
       throw new Error();
@@ -5574,6 +5573,8 @@ function createMountedMapOwner(ports2) {
   let sourceKey;
   let sourceObject;
   let selectedTheme;
+  let selectedTimeOfDay;
+  const timeSelection = () => !blendSelection && props?.timeOfDay !== void 0 ? { timeOfDay: props.timeOfDay } : {};
   let colorScheme;
   let appearanceRelease;
   let appearanceEpoch = 0;
@@ -5891,7 +5892,13 @@ function createMountedMapOwner(ports2) {
         cancelJob(epoch);
         epoch.cache.clear();
         if (!disposed && foreground && current === epoch && epoch.live && props) {
-          track(core.replace(props.source, { theme: selectionTheme(), colorScheme }));
+          track(
+            core.replace(props.source, {
+              theme: selectionTheme(),
+              colorScheme,
+              ...timeSelection()
+            })
+          );
         }
         return;
       }
@@ -5928,7 +5935,7 @@ function createMountedMapOwner(ports2) {
   function select() {
     if (disposed || !props || !current?.live) return;
     current.hosted.select();
-    track(core.replace(props.source, { theme: selectionTheme(), colorScheme }));
+    track(core.replace(props.source, { theme: selectionTheme(), colorScheme, ...timeSelection() }));
   }
   function appearance(theme) {
     if (theme === "system" === Boolean(appearanceRelease)) return;
@@ -6007,7 +6014,7 @@ function createMountedMapOwner(ports2) {
       if (changedBlend || !blend) blendTheme = nearest;
       const key2 = source && JSON.stringify(source);
       const changedSource = !initialized || key2 !== sourceKey || key2 === void 0 && sourceObject !== next.source;
-      const changedTheme = !initialized || !blend && next.theme !== selectedTheme;
+      const changedTheme = !initialized || !blend && (next.theme !== selectedTheme || next.timeOfDay !== selectedTimeOfDay);
       const changedOptions = JSON.stringify(options) !== JSON.stringify(mapOptions);
       camera = input;
       mapOptions = options;
@@ -6020,6 +6027,7 @@ function createMountedMapOwner(ports2) {
         sourceObject = next.source;
       }
       selectedTheme = next.theme;
+      selectedTimeOfDay = next.timeOfDay;
       initialized = true;
       try {
         appearance(next.theme);

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-Bwl-gB-I.js';
+import { M as MapView, a as MapViewChangeEvent, b as MapInitialViewInputs, c as MapCameraProps } from '../contract-Bp-Im7tj.js';
 import '@maplibre/maplibre-react-native';
 import 'react';
 import 'react-native';

package/dist/internal/hosted-binding.js

@@ -140,7 +140,9 @@ function snapshotHostedNativeManifestIdentity(source) {
     if (sourceUrl !== expected || finalUrl !== expected) throw new Error();
     const manifest = field(source, "manifest");
     const maps = field(manifest, "maps");
-    if (field(manifest, "version") !== 1 || names(maps, 1)[0] !== name) throw new Error();
+    const manifestVersion = field(manifest, "version");
+    if (manifestVersion !== 1 && manifestVersion !== 2 || names(maps, 1)[0] !== name)
+      throw new Error();
     const declared = field(maps, name);
     if (field(declared, "mapId") !== mapId || field(declared, "usageMode") !== "session")
       throw new Error();

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

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

package/dist/internal/interactions.js

@@ -226,7 +226,7 @@ function parseManifest(style) {
   if (nativeInteractionField(style, "version") !== 8) throw new Error();
   const metadata = nativeInteractionField(style, "metadata");
   const artifact = snapshotNativeInteractionJson(nativeInteractionField(metadata, "tileflow:interaction-manifest"));
-  if (nativeInteractionField(artifact, "version") !== 2) throw new Error();
+  if (nativeInteractionField(artifact, "version") !== 3) throw new Error();
   const poi = nativeInteractionField(nativeInteractionField(artifact, "domains"), "poi");
   if (nativeInteractionField(poi, "identity") !== "maplibre-feature-id-if-present") throw new Error();
   const hitTesting = nativeInteractionField(poi, "hitTesting");
@@ -269,10 +269,9 @@ function parseManifest(style) {
     const layerId = nativeInteractionField(input, "layerId");
     const source = nativeInteractionField(input, "source");
     const sourceLayer = nativeInteractionField(input, "sourceLayer");
-    const layerCategory = nativeInteractionField(input, "category");
     const kind = nativeInteractionField(input, "representation");
     const priority = nativeInteractionField(input, "priority");
-    if (!name(layerId) || !name(source) || sourceLayer !== void 0 && !name(sourceLayer) || !category(layerCategory) || !representation(kind) || typeof priority !== "number" || !Number.isSafeInteger(priority) || priority < 0 || priority > 1e5 || ids.has(layerId) || nativeInteractionField(input, "anchor") !== "pointer-coordinate")
+    if (!name(layerId) || !name(source) || sourceLayer !== void 0 && !name(sourceLayer) || !representation(kind) || typeof priority !== "number" || !Number.isSafeInteger(priority) || priority < 0 || priority > 1e5 || ids.has(layerId) || nativeInteractionField(input, "anchor") !== "pointer-coordinate")
       throw new Error();
     const actual = physical.get(layerId);
     if (!actual || nativeInteractionField(actual, "source") !== source || nativeInteractionField(actual, "source-layer") !== sourceLayer)
@@ -286,7 +285,6 @@ function parseManifest(style) {
       layerId,
       source,
       ...sourceLayer === void 0 ? {} : { sourceLayer },
-      category: layerCategory,
       representation: kind,
       priority
     });
@@ -340,8 +338,11 @@ function choose(features, manifest, bindings, coordinate, queried) {
     if (!layer || !allowed.has(layer.layerId)) continue;
     if (nativeInteractionField(feature, "source") !== layer.source || nativeInteractionField(feature, "sourceLayer") !== layer.sourceLayer)
       throw new Error();
+    const featureProperties = properties(nativeInteractionField(feature, "properties"), manifest.fields);
+    const featureCategory = featureProperties.category;
+    if (!category(featureCategory)) throw new Error();
     const binding = bindings.find(
-      (value) => value.target.kind === "semantic-feature" && value.target.domain === "poi" && (!value.target.categories || value.target.categories.includes(layer.category))
+      (value) => value.target.kind === "semantic-feature" && value.target.domain === "poi" && (!value.target.categories || value.target.categories.includes(featureCategory))
     );
     if (!binding) continue;
     const stable = featureId(nativeInteractionField(feature, "id"));
@@ -351,9 +352,9 @@ function choose(features, manifest, bindings, coordinate, queried) {
       coordinate,
       bindingId: binding.id,
       feature: {
-        category: layer.category,
+        category: featureCategory,
         ...stable === void 0 ? {} : { id: stable },
-        properties: properties(nativeInteractionField(feature, "properties"), manifest.fields)
+        properties: featureProperties
       }
     });
     const candidate = { layer, renderedIndex, match: Object.freeze({ binding, target }) };
@@ -416,7 +417,7 @@ function createNativePoiAdapter() {
     },
     supports(target) {
       const parsed = manifest;
-      return !!parsed && inspect(lease, generation) === "current" && manifest === parsed && parsed.layers.some((layer) => layer.category === target.feature.category);
+      return !!parsed && inspect(lease, generation) === "current" && manifest === parsed && parsed.layers.length > 0 && category(target.feature.category);
     },
     replaceStyle(next) {
       if (disposed) return emptyDiagnostics;
@@ -472,11 +473,7 @@ function createNativePoiAdapter() {
       if (!owner || !selected) return answer(failure());
       const ownership = inspect(owner, expected);
       if (ownership !== "current") return answer(ownership === "error" ? failure() : stale);
-      const layers = selected.layers.filter(
-        (layer) => bindings.some(
-          (binding) => binding.target.kind === "semantic-feature" && (!binding.target.categories || binding.target.categories.includes(layer.category))
-        )
-      ).map((layer) => layer.layerId);
+      const layers = selected.layers.map((layer) => layer.layerId);
       if (!layers.length) return answer(miss);
       if (!invocationIsLive()) return Promise.resolve(stale);
       const request = Object.freeze({

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

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

package/dist/internal/native-configuration-bridge.js

@@ -143,7 +143,9 @@ function snapshotHostedNativeManifestIdentity(source) {
     if (sourceUrl !== expected || finalUrl !== expected) throw new Error();
     const manifest = field(source, "manifest");
     const maps = field(manifest, "maps");
-    if (field(manifest, "version") !== 1 || names(maps, 1)[0] !== name) throw new Error();
+    const manifestVersion = field(manifest, "version");
+    if (manifestVersion !== 1 && manifestVersion !== 2 || names(maps, 1)[0] !== name)
+      throw new Error();
     const declared = field(maps, name);
     if (field(declared, "mapId") !== mapId || field(declared, "usageMode") !== "session")
       throw new Error();

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

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

package/docs/native-admission.md

@@ -6,7 +6,7 @@ The mounted owner prepares a **bounded Style/TileJSON resource closure** before
 
 ## Exact native dependencies
 
-The source targets React 19.2.0, React Native 0.83.10, MapLibre React Native 11.3.10, MapLibre Native Android 13.2.0 and MapLibre Native iOS 6.26.0. Android's HTTP dependency is OkHttp 4.12.0. These pins and the existence of source tests are **not evidence** of a successful build, device run, Hosted service or app-store acceptance; qualify the exact revision in the intended host.
+The source targets React 19.2.0, React Native 0.83.10, MapLibre React Native 11.5.0, MapLibre Native Android 13.6.1 and MapLibre Native iOS 6.31.0. Android's HTTP dependency is OkHttp 4.12.0. These pins and the existence of source tests are **not evidence** of a successful build, device run, Hosted service or app-store acceptance; qualify the exact revision in the intended host.
 
 Android's library build uses the host's Android Gradle/Kotlin plugins and SDK settings. `react-native.config.cjs` autolinks `TileflowNativeAdmissionPackage`, which registers the private admission, document, configuration and surface modules. The library depends on the autolinked `:maplibre_maplibre-react-native` project and rejects conflicting MapLibre Native versions rather than selecting another version silently.
 
@@ -17,7 +17,7 @@ $MLRN.post_install(installer)
 tileflow_native_admission_post_install(installer)
 ```
 
-The helper requires the MapLibre distribution reference with `exactVersion` 6.26.0 and reuses that product for the Tileflow pod/test targets. It does not add another SDK or change the pin.
+The helper requires the MapLibre distribution reference with `exactVersion` 6.31.0 and reuses that product for the Tileflow pod/test targets. It does not add another SDK or change the pin.
 
 ## Installation ownership
 

package/ios/tileflow_native_admission.rb

@@ -4,7 +4,7 @@
 def tileflow_native_admission_post_install(installer)
 	project = installer.pods_project
 	url = 'https://github.com/maplibre/maplibre-gl-native-distribution'
-	version = '6.26.0'
+	version = '6.31.0'
 	refs = project.root_object.package_references.select do |reference|
 		reference.respond_to?(:repositoryURL) && reference.repositoryURL == url
 	end
@@ -12,7 +12,7 @@ def tileflow_native_admission_post_install(installer)
 	reference = refs.first
 	requirement = reference.requirement.transform_keys(&:to_s)
 	unless requirement == { 'kind' => 'exactVersion', 'version' => version }
-		raise 'Tileflow native admission requires the exact MapLibre Native 6.26.0 SPM product'
+		raise 'Tileflow native admission requires the exact MapLibre Native 6.31.0 SPM product'
 	end
 	if defined?($MLRN_NATIVE_VERSION) && $MLRN_NATIVE_VERSION.to_s != version
 		raise 'Conflicting MapLibre Native version for Tileflow native admission'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/react-native",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.5",
   "license": "Apache-2.0",
   "description": "Tileflow maps, camera control and semantic interactions for React Native.",
   "type": "module",
@@ -36,16 +36,16 @@
     }
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.32 <0.1.0-beta.0",
-    "@tileflow/interactions": ">=0.1.0-alpha.4 <0.1.0-beta.0"
+    "@tileflow/core": ">=0.1.0-alpha.38 <0.1.0-beta.0",
+    "@tileflow/interactions": ">=0.1.0-alpha.6 <0.1.0-beta.0"
   },
   "peerDependencies": {
-    "@maplibre/maplibre-react-native": "11.3.10",
+    "@maplibre/maplibre-react-native": "11.5.0",
     "react": "19.2.0",
     "react-native": "0.83.10"
   },
   "devDependencies": {
-    "@maplibre/maplibre-react-native": "11.3.10",
+    "@maplibre/maplibre-react-native": "11.5.0",
     "@types/react": "^19.2.17",
     "react": "19.2.0",
     "react-native": "0.83.10"