@tileflow/svelte 0.1.0-alpha.20 → 0.1.0-alpha.22

package/README.md

@@ -65,8 +65,11 @@ or evaluating MapLibre. All environments follow the same published manifest cont
 Hosted maps automatically preflight a short-lived commercial session grant before eligible
 resources. Setting `analytics={{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.
 
 ## Annotations and overlays
@@ -145,8 +148,8 @@ owned by the shared MapLibre interaction runtime.
 />
 ```
 
-`annotations` and the legacy `markers` prop are mutually exclusive. So are controlled
-`interactionState` and uncontrolled `defaultInteractionState`. `interactions` binds tooltips and
+`annotations` is the only application-owned marker input. Controlled `interactionState` and
+uncontrolled `defaultInteractionState` are mutually exclusive. `interactions` binds tooltips and
 popups to semantic POIs exposed by the compiled style metadata; applications select the stable
 `poi` domain and optional categories rather than physical style-layer IDs.
 
@@ -161,8 +164,8 @@ with a POI popup (or the reverse) closes the previous owner before opening the n
 order remains `popup:close` followed by `popup:open`.
 
 Annotations and semantic interactions are interactive-only. The TypeScript API excludes
-annotations, legacy markers, interactions, interaction state, snippets, and interaction callbacks
-from the `mode="image"` branch. Untyped JavaScript that supplies them still receives an
+annotations, interactions, interaction state, snippets, and interaction callbacks from the
+`mode="image"` branch. Untyped JavaScript that supplies them still receives an
 `UNSUPPORTED_MODE` diagnostic and capture readiness `error`, rather than pretending the static image
 contains live overlays.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/svelte",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.22",
   "license": "Apache-2.0",
   "description": "Svelte component for rendering Tileflow maps with MapLibre.",
   "type": "module",
@@ -25,10 +25,7 @@
   "types": "./src/index.d.ts",
   "files": [
     "src",
-    "LICENSE",
-    "NOTICE",
-    "GENERATED_OUTPUT_LICENSE.md",
-    "TRADEMARKS.md"
+    "LICENSE"
   ],
   "exports": {
     ".": {
@@ -47,8 +44,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.24 <0.1.0-beta.0",
+    "@tileflow/interactions": ">=0.1.0-alpha.2 <0.1.0-beta.0"
   },
   "peerDependencies": {
     "maplibre-gl": ">=5 <7",

package/src/TileflowMap.svelte

@@ -24,7 +24,6 @@
     resolveTileflowRuntimeView,
     resolveTileflowStaticImageUrl,
     shouldLoadTileflowManifest,
-    type TileflowMapMarker,
     type TileflowRuntimeManifestMap,
   } from '@tileflow/core/runtime';
   import {
@@ -36,6 +35,7 @@
     getTileflowSystemColorScheme,
     loadTileflowStyleFonts,
     registerTileflowContourProtocol,
+    registerTileflowPmtilesProtocol,
     registerTileflowWorldRequestBridge,
     subscribeTileflowSystemColorScheme,
     type TileflowFairUseNoticeController,
@@ -61,7 +61,6 @@
     createTileflowMapLibreDomRuntime,
     createTileflowMapLibreInteractionCoordinator,
     createTileflowMapLibreSemanticDomRuntime,
-    normalizeTileflowLegacyMarkers,
     type TileflowMapLibreDomRenderTarget,
     type TileflowMapLibreDomRuntime,
     type TileflowMapLibreInteractionCoordinator,
@@ -89,7 +88,6 @@
   export let interactionState: TileflowMapProps['interactionState'] = undefined;
   export let mapOptions: TileflowMapProps['mapOptions'] = undefined;
   export let marker: TileflowMapProps['marker'] = undefined;
-  export let markers: TileflowMapProps['markers'] = undefined;
   export let mode: NonNullable<TileflowMapProps['mode']> = 'interactive';
   export let onInteractionDiagnostic: TileflowMapProps['onInteractionDiagnostic'] = undefined;
   export let onInteractionEvent: TileflowMapProps['onInteractionEvent'] = undefined;
@@ -137,7 +135,6 @@
   let interactionReadinessTargetKeys: readonly string[] = [];
   let hadInteractionErrors = false;
   let interactionRuntimesDisposing = false;
-  let legacyTitles: ReadonlyMap<string, string> = new Map();
   let mapResizeObserver: ResizeObserver | null = null;
   let mapWorldRequestBridge: TileflowWorldRequestBridge | null = null;
   let themeController: TileflowThemeController | null = null;
@@ -248,7 +245,7 @@
       ? mapCaptureState
       : 'loading';
   $: frameStyle = `height: ${formatHeight(height)}; min-height: 240px; overflow: hidden; position: relative; width: 100%;`;
-  $: annotationResolution = resolveAnnotationInput(annotations, markers);
+  $: annotationResolution = resolveAnnotationInput(annotations);
   $: interactionBindingResolution = resolveInteractionBindingInput(interactions);
   $: interactionStateDiagnostics = validateInteractionStateInput(
     interactionState,
@@ -256,7 +253,6 @@
   );
   $: hasInteractionConfiguration =
     annotations !== undefined ||
-    markers !== undefined ||
     interactions !== undefined ||
     interactionState !== undefined ||
     defaultInteractionState !== undefined ||
@@ -331,7 +327,6 @@
 
   $: if (mounted) {
     annotations;
-    markers;
     syncAnnotations();
   }
 
@@ -577,6 +572,7 @@
     });
     mapFairUseNotice = attachTileflowFairUseNotice(targetContainer);
     registerTileflowContourProtocol({addProtocol: maplibregl.addProtocol});
+    registerTileflowPmtilesProtocol({addProtocol: maplibregl.addProtocol});
     mapWorldRequestBridge = registerTileflowWorldRequestBridge({
       addProtocol: maplibregl.addProtocol,
       onNotice: mapFairUseNotice.update,
@@ -630,7 +626,7 @@
         TileflowAnnotation
       >({
         createMarker({annotation, element}) {
-          element.title = legacyTitles.get(annotation.id) ?? annotation.ariaLabel;
+          element.title = annotation.ariaLabel;
           return new maplibregl.Marker({element});
         },
         createOverlay({container: overlayContainer, kind}) {
@@ -650,7 +646,7 @@
         map: maplibreMap,
         onInteractionStateChange: interactionCoordinator.requestInteractionState,
         updateMarker(_markerInstance, {annotation, element}) {
-          element.title = legacyTitles.get(annotation.id) ?? annotation.ariaLabel;
+          element.title = annotation.ariaLabel;
         },
       });
       annotationRuntime = annotationInteractionsForMap;
@@ -823,7 +819,6 @@
   }
 
   function syncAnnotations() {
-    legacyTitles = annotationResolution.titles;
     if (!annotationRuntime) return;
 
     try {
@@ -942,7 +937,6 @@
     annotations: readonly TileflowAnnotation[];
     diagnostics: readonly TileflowInteractionDiagnostic[];
     ok: boolean;
-    titles: ReadonlyMap<string, string>;
   }>;
 
   type InteractionBindingResolution = Readonly<{
@@ -953,39 +947,18 @@
 
   function resolveAnnotationInput(
     nextAnnotations: readonly TileflowAnnotation[] | undefined,
-    nextMarkers: readonly TileflowMapMarker[] | undefined,
   ): AnnotationResolution {
-    if (nextAnnotations !== undefined && nextMarkers !== undefined) {
-      return {
-        annotations: [],
-        diagnostics: [
-          createInteractionDiagnostic(
-            'INVALID_DOCUMENT',
-            'The annotations and legacy markers props are mutually exclusive.',
-          ),
-        ],
-        ok: false,
-        titles: new Map(),
-      };
-    }
-
-    const normalized = normalizeTileflowLegacyMarkers(nextMarkers ?? []);
-    const candidates = nextAnnotations ?? normalized.annotations;
-    const titles =
-      nextAnnotations === undefined
-        ? normalized.titles
-        : new Map(nextAnnotations.map((annotation) => [annotation.id, annotation.ariaLabel]));
+    const candidates = nextAnnotations ?? [];
     const validation = validateTileflowAnnotations(candidates);
     if (!validation.ok) {
       return {
         annotations: [],
         diagnostics: validation.diagnostics,
         ok: false,
-        titles,
       };
     }
 
-    return {annotations: candidates, diagnostics: [], ok: true, titles};
+    return {annotations: candidates, diagnostics: [], ok: true};
   }
 
   function resolveInteractionBindingInput(

package/src/index.d.ts

@@ -3,7 +3,6 @@ import type {Snippet, SvelteComponentTyped} from 'svelte';
 import type {TileflowThemeTransition} from '@tileflow/core/browser';
 import type {
   TileflowAnalytics,
-  TileflowMapMarker,
   TileflowRuntimeSource,
   TileflowThemeSelection,
 } from '@tileflow/core/runtime';
@@ -21,12 +20,9 @@ export type TileflowMapMode = 'interactive' | 'image';
 export type TileflowMapOptions = Omit<MapLibreMapOptions, 'container' | 'style'>;
 export type TileflowMapSource = TileflowRuntimeSource;
 
-export type TileflowMapMarkerSnippet<TAnnotation extends TileflowAnnotation = TileflowAnnotation> =
-  Snippet<[context: TileflowAnnotationViewContext<TAnnotation>]>;
-
 export type TileflowMapAnnotationSnippet<
   TAnnotation extends TileflowAnnotation = TileflowAnnotation,
-> = TileflowMapMarkerSnippet<TAnnotation>;
+> = Snippet<[context: TileflowAnnotationViewContext<TAnnotation>]>;
 
 export type TileflowMapInteractionSnippet<
   TAnnotation extends TileflowAnnotation = TileflowAnnotation,
@@ -50,15 +46,9 @@ type TileflowMapBaseProps = {
 
 export type TileflowMapAnnotationProps<
   TAnnotation extends TileflowAnnotation = TileflowAnnotation,
-> =
-  | {
-      annotations?: readonly TAnnotation[];
-      markers?: never;
-    }
-  | {
-      annotations?: never;
-      markers?: readonly TileflowMapMarker[];
-    };
+> = {
+  annotations?: readonly TAnnotation[];
+};
 
 export type TileflowMapInteractionStateProps =
   | {
@@ -78,7 +68,7 @@ type TileflowMapInteractiveProps<TAnnotation extends TileflowAnnotation> =
   TileflowMapAnnotationProps<TAnnotation> &
     TileflowMapInteractionStateProps & {
       interactions?: readonly TileflowInteractionBinding[];
-      marker?: TileflowMapMarkerSnippet<TAnnotation>;
+      marker?: TileflowMapAnnotationSnippet<TAnnotation>;
       mode?: 'interactive';
       onInteractionDiagnostic?: (diagnostic: TileflowInteractionDiagnostic) => void;
       onInteractionEvent?: (event: TileflowInteractionEvent<TAnnotation>) => void;
@@ -93,7 +83,6 @@ type TileflowMapImageProps = {
   interactions?: never;
   interactionState?: never;
   marker?: never;
-  markers?: never;
   mode: 'image';
   onInteractionDiagnostic?: never;
   onInteractionEvent?: never;

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.