@tileflow/vue 0.1.0-alpha.20 → 0.1.0-alpha.21

package/README.md

@@ -143,10 +143,8 @@ const interactionState = ref<TileflowInteractionState>({popup: null});
 ```
 
 Omit `interactionState` and use `default-interaction-state` for uncontrolled state. Do not provide
-both or switch ownership modes during a component instance's lifetime. Likewise, the legacy
-`markers` prop and `annotations` are mutually exclusive. Legacy markers
-are normalized into annotations and retain their exact `title = label ?? id` behavior while the
-new API uses singular `coordinate` and required `ariaLabel`.
+both or switch ownership modes during a component instance's lifetime. `annotations` is the only
+application-owned marker input and uses singular `coordinate` plus required `ariaLabel`.
 
 The `marker` slot is annotation-only and preserves the annotation's generic `data` type.
 `tooltip` and `popup` receive the general `TileflowInteractionViewContext`; narrow
@@ -169,8 +167,11 @@ lazily, and the component and its interaction imports remain SSR-safe.
 Hosted maps automatically preflight a short-lived commercial session grant before eligible
 resources. Setting `analytics` with `enabled: false` disables the optional beacon only; it does not
 remove hosted authorization or override a user `mapOptions.transformRequest` callback.
+Use `:analytics="{surfaceId: 'store-locator'}"` when the same Map is embedded in several stable
+product locations. Missing or invalid Surface IDs become `default`; do not use URLs, branches,
+random instance IDs, or user IDs.
 Direct Tileflow World maps keep early `GRACE` silent, show a compact accessible owner-action pill
-when late `GRACE` is activated, and show a stronger banner in `CLAIM_REQUIRED`. Missing tiles and
+when late `GRACE` is activated, and show a stronger banner in `MANAGED_REQUIRED`. Missing tiles and
 MapLibre failures do not remove that recovery path.
 
 ## Headless capture readiness

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { MapOptions, Map } from 'maplibre-gl';
 import { DefineComponent, VNodeChild } from 'vue';
 import { TileflowThemeTransition } from '@tileflow/core/browser';
-import { TileflowRuntimeSource, TileflowThemeSelection, TileflowAnalytics, TileflowMapMarker } from '@tileflow/core/runtime';
+import { TileflowRuntimeSource, TileflowThemeSelection, TileflowAnalytics } from '@tileflow/core/runtime';
 import { TileflowAnnotation, TileflowInteractionJsonValue, TileflowInteractionState, TileflowInteractionBinding, TileflowInteractionDiagnostic, TileflowInteractionEvent, TileflowAnnotationViewContext, TileflowInteractionViewContext } from '@tileflow/interactions';
 
 type TileflowMapStyleSourceProps = {
@@ -31,13 +31,6 @@ type TileflowMapSharedProps = {
     mapOptions?: TileflowMapOptions;
     zoom?: number;
 };
-type TileflowMapAnnotationInput<TAnnotation extends TileflowAnnotation> = {
-    annotations?: readonly TAnnotation[];
-    markers?: never;
-} | {
-    annotations?: never;
-    markers?: readonly TileflowMapMarker[];
-};
 type TileflowMapStateInput = {
     defaultInteractionState?: never;
     interactionState?: TileflowInteractionState;
@@ -45,7 +38,8 @@ type TileflowMapStateInput = {
     defaultInteractionState?: TileflowInteractionState;
     interactionState?: never;
 };
-type TileflowMapInteractiveProps<TAnnotation extends TileflowAnnotation> = TileflowMapSharedProps & TileflowMapAnnotationInput<TAnnotation> & TileflowMapStateInput & {
+type TileflowMapInteractiveProps<TAnnotation extends TileflowAnnotation> = TileflowMapSharedProps & TileflowMapStateInput & {
+    annotations?: readonly TAnnotation[];
     interactions?: readonly TileflowInteractionBinding[];
     interactive?: boolean;
     mode?: 'interactive';
@@ -56,7 +50,6 @@ type TileflowMapImageProps = TileflowMapSharedProps & {
     interactionState?: never;
     interactions?: never;
     interactive?: never;
-    markers?: never;
     mode: 'image';
 };
 type TileflowMapProps<TAnnotation extends TileflowAnnotation = TileflowAnnotation> = (TileflowMapInteractiveProps<TAnnotation> | TileflowMapImageProps) & TileflowMapStyleSourceProps;
@@ -67,7 +60,6 @@ type RuntimeTileflowMapProps = TileflowMapSharedProps & TileflowMapStyleSourcePr
     interactionState?: TileflowInteractionState;
     interactions?: readonly TileflowInteractionBinding[];
     interactive?: boolean;
-    markers?: readonly TileflowMapMarker[];
     mode?: TileflowMapMode;
 };
 type PublicTileflowMapStatics = Pick<DefineComponent<RuntimeTileflowMapProps>, keyof DefineComponent<RuntimeTileflowMapProps>>;

package/dist/index.js

@@ -22,6 +22,7 @@ import {
   getTileflowSystemColorScheme,
   loadTileflowStyleFonts,
   registerTileflowContourProtocol,
+  registerTileflowPmtilesProtocol,
   registerTileflowWorldRequestBridge,
   subscribeTileflowSystemColorScheme
 } from "@tileflow/core/browser";
@@ -57,33 +58,13 @@ import {
   validateTileflowAnnotations,
   validateTileflowInteractionBindings
 } from "@tileflow/interactions";
-import { normalizeTileflowLegacyMarkers } from "@tileflow/interactions/maplibre";
-function resolveTileflowVueAnnotations({
-  annotations,
-  markers
-}) {
-  if (annotations !== void 0 && markers !== void 0) {
-    return {
-      annotations: [],
-      diagnostics: [
-        createTileflowVueInteractionDiagnostic(
-          "INVALID_DOCUMENT",
-          "The annotations and legacy markers props are mutually exclusive."
-        )
-      ],
-      legacyTitles: /* @__PURE__ */ new Map(),
-      ok: false
-    };
-  }
-  const normalizedLegacyMarkers = normalizeTileflowLegacyMarkers(markers ?? []);
-  const legacyTitles = markers === void 0 ? /* @__PURE__ */ new Map() : normalizedLegacyMarkers.titles;
-  const candidates = annotations ?? normalizedLegacyMarkers.annotations;
+function resolveTileflowVueAnnotations({ annotations }) {
+  const candidates = annotations ?? [];
   const validation = validateTileflowAnnotations(candidates);
   if (!validation.ok) {
     return {
       annotations: [],
       diagnostics: validation.diagnostics,
-      legacyTitles,
       ok: false
     };
   }
@@ -92,7 +73,6 @@ function resolveTileflowVueAnnotations({
     // contexts keep the caller's typed annotation and data identities.
     annotations: candidates,
     diagnostics: [],
-    legacyTitles,
     ok: true
   };
 }
@@ -213,7 +193,6 @@ var TileflowMap = defineComponent({
     interactions: Array,
     interactionState: Object,
     mapOptions: Object,
-    markers: Array,
     mode: {
       default: "interactive",
       type: String
@@ -265,7 +244,6 @@ var TileflowMap = defineComponent({
     let activeSemanticDiagnosticKeys = /* @__PURE__ */ new Set();
     let annotationRuntimeDiagnostics = [];
     let semanticRuntimeDiagnostics = [];
-    let legacyTitles = /* @__PURE__ */ new Map();
     let imageResizeObserver = null;
     let mapFairUseNotice = null;
     let mapLifecycle = null;
@@ -284,8 +262,7 @@ var TileflowMap = defineComponent({
     const isImageMode = computed(() => resolvedMode.value === "image");
     const annotationResolution = computed(
       () => resolveTileflowVueAnnotations({
-        annotations: props.annotations,
-        markers: props.markers
+        annotations: props.annotations
       })
     );
     const interactionBindingResolution = computed(
@@ -309,7 +286,7 @@ var TileflowMap = defineComponent({
       return diagnostics;
     });
     const hasInteractionConfiguration = computed(
-      () => props.annotations !== void 0 || props.markers !== void 0 || props.interactions !== void 0 || props.interactionState !== void 0 || props.defaultInteractionState !== void 0 || slots.marker !== void 0 || slots.popup !== void 0 || slots.tooltip !== void 0
+      () => props.annotations !== void 0 || props.interactions !== void 0 || props.interactionState !== void 0 || props.defaultInteractionState !== void 0 || slots.marker !== void 0 || slots.popup !== void 0 || slots.tooltip !== void 0
     );
     const interactionInputDiagnostics = computed(() => {
       const diagnostics = [
@@ -661,7 +638,6 @@ var TileflowMap = defineComponent({
     };
     const syncAnnotationRuntime = () => {
       const resolution = annotationResolution.value;
-      legacyTitles = new Map(resolution.legacyTitles);
       if (!annotationRuntime) return;
       try {
         annotationRuntime.reconcile(
@@ -740,6 +716,7 @@ var TileflowMap = defineComponent({
       });
       mapFairUseNotice = attachTileflowFairUseNotice(container);
       registerTileflowContourProtocol({ addProtocol: maplibregl.addProtocol });
+      registerTileflowPmtilesProtocol({ addProtocol: maplibregl.addProtocol });
       mapWorldRequestBridge = registerTileflowWorldRequestBridge({
         addProtocol: maplibregl.addProtocol,
         onNotice: mapFairUseNotice.update
@@ -782,7 +759,7 @@ var TileflowMap = defineComponent({
       try {
         const mapInteractions = createTileflowMapLibreDomRuntime({
           createMarker({ annotation, element }) {
-            element.title = legacyTitles.get(annotation.id) ?? annotation.ariaLabel;
+            element.title = annotation.ariaLabel;
             return new maplibregl.Marker({ element });
           },
           customMarker: slots.marker !== void 0,
@@ -802,7 +779,7 @@ var TileflowMap = defineComponent({
           map,
           onInteractionStateChange: interactionCoordinator.requestInteractionState,
           updateMarker(_marker, { annotation, element }) {
-            element.title = legacyTitles.get(annotation.id) ?? annotation.ariaLabel;
+            element.title = annotation.ariaLabel;
           }
         });
         annotationRuntime = mapInteractions;
@@ -1044,7 +1021,7 @@ var TileflowMap = defineComponent({
       { flush: "post" }
     );
     watch(
-      () => [props.annotations, props.markers],
+      () => props.annotations,
       () => syncAnnotationRuntime(),
       { deep: true, flush: "post" }
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/vue",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.21",
   "license": "Apache-2.0",
   "description": "Vue component for rendering Tileflow maps with MapLibre.",
   "type": "module",
@@ -41,8 +41,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.21 <0.1.0-beta.0",
-    "@tileflow/interactions": ">=0.1.0-alpha.0 <0.1.0-beta.0"
+    "@tileflow/core": ">=0.1.0-alpha.22 <0.1.0-beta.0",
+    "@tileflow/interactions": ">=0.1.0-alpha.1 <0.1.0-beta.0"
   },
   "peerDependencies": {
     "maplibre-gl": ">=5 <7",