@tileflow/core 0.1.0-alpha.21 → 0.1.0-alpha.23

package/dist/browser.d.ts

@@ -1,8 +1,4 @@
-import { T as TileflowAnalytics, a as TileflowStyleFontFace, b as TileflowRuntimeStyle, c as TileflowSessionController, d as TileflowRuntimeColorScheme } from './runtime-C4MtSzkB.js';
-import { M as MapLibreStyle } from './types-DlUGI6LC.js';
-import 'zod';
-
-type TileflowFairUseNoticeState = 'GRACE' | 'CLAIM_REQUIRED';
+type TileflowFairUseNoticeState = 'GRACE' | 'MANAGED_REQUIRED';
 type TileflowFairUseNotice = Readonly<{
     action: string;
     helpUrl: string;
@@ -36,6 +32,67 @@ declare function registerTileflowWorldRequestBridge(input: {
 declare function tileflowFairUseNoticeMessage(state: TileflowFairUseNoticeState): string;
 declare function attachTileflowFairUseNotice(container: HTMLElement): TileflowFairUseNoticeController;
 
+type TileflowColor = `#${string}`;
+type MapLibreSprite = string | Array<{
+    id: string;
+    url: string;
+}>;
+type TileflowProjection = 'globe' | 'mercator';
+type TileflowLight = {
+    anchor?: 'map' | 'viewport';
+    color?: TileflowColor;
+    intensity?: number;
+    position?: readonly [number, number, number];
+};
+type MapLibreStyle = {
+    version: 8;
+    name: string;
+    glyphs?: string;
+    light?: TileflowLight;
+    projection?: {
+        type: TileflowProjection;
+    };
+    sprite?: MapLibreSprite;
+    sources: Record<string, Record<string, unknown>>;
+    layers: Array<Record<string, unknown>>;
+    terrain?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+
+type TileflowRuntimeColorScheme = 'dark' | 'light';
+
+type TileflowAnalytics = {
+    apiUrl?: string;
+    endpoint?: string;
+    enabled?: boolean;
+    mapId?: string;
+    metadata?: Record<string, unknown>;
+    projectId?: string;
+    sdkVersion?: string;
+    source?: string;
+    styleId?: string;
+    surfaceId?: string;
+};
+type TileflowSessionController = {
+    readonly sessionId: string;
+    resolveRequestUrl(url: string, analytics: TileflowAnalytics | undefined): Promise<string | undefined>;
+};
+type TileflowRuntimeStyle = {
+    analytics?: TileflowAnalytics;
+    colorScheme?: TileflowRuntimeColorScheme;
+    /** An explicit empty array means the manifest declares that no web fonts are required. */
+    fontFaces?: TileflowStyleFontFace[];
+    revision?: string;
+    style: MapLibreStyle | string;
+    theme?: string;
+};
+type TileflowStyleFontFace = {
+    family: string;
+    source: string;
+    style?: 'italic' | 'normal' | 'oblique';
+    weight?: '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900';
+};
+
 declare const tileflowMaplibreContourVersion: "0.1.0";
 type TileflowContourProtocolRequest = Readonly<{
     url: string;
@@ -56,6 +113,25 @@ type TileflowContourProtocolRegistrationOptions = {
 /** Registers the one self-contained protocol emitted by every compiled contour source. */
 declare function registerTileflowContourProtocol(registry: TileflowContourProtocolRegistry, options?: TileflowContourProtocolRegistrationOptions): void;
 
+type TileflowPmtilesProtocolHandler = (request: Readonly<{
+    type?: string;
+    url: string;
+}>, abortController: AbortController) => Promise<Readonly<{
+    cacheControl?: string;
+    data: unknown;
+    expires?: string;
+}>>;
+type TileflowPmtilesProtocolRegistry = Readonly<{
+    addProtocol: (name: string, handler: TileflowPmtilesProtocolHandler) => void;
+}>;
+type TileflowPmtilesProtocolRegistrationOptions = Readonly<{
+    maximumDirectoryDepth?: number;
+}>;
+declare const tileflowPmtilesMaximumDirectoryDepth: 32;
+declare const tileflowPmtilesProtocol: "tileflow-pmtiles";
+/** Register only Tileflow's managed PMTiles namespace. Third-party `pmtiles://` remains untouched. */
+declare function registerTileflowPmtilesProtocol(registry: TileflowPmtilesProtocolRegistry, options?: TileflowPmtilesProtocolRegistrationOptions): void;
+
 type TileflowMapReadinessState = 'error' | 'idle' | 'loading';
 /** Read the browser preference without persisting or mutating user state. */
 declare function getTileflowSystemColorScheme(): TileflowRuntimeColorScheme;
@@ -130,11 +206,6 @@ type TileflowComposedRequest<TRequest extends TileflowTransformRequestParameters
 type TileflowTransformRequest<TRequest extends TileflowTransformRequestParameters, TResourceType> = (url: string, resourceType?: TResourceType) => Promise<TileflowComposedRequest<TRequest>> | TileflowComposedRequest<TRequest> | undefined;
 type TileflowUserTransformRequest<TRequest extends TileflowTransformRequestParameters, TResourceType> = (url: string, resourceType?: TResourceType) => Promise<TRequest> | TRequest | undefined;
 type TileflowAsyncAnalyticsTiming = 'request' | 'resolution';
-type TileflowMarkerController<TMap, TDefinition, TMarker> = {
-    clear: () => void;
-    dispose: () => void;
-    replace: (map: TMap, definitions: readonly TDefinition[]) => void;
-};
 declare function createTileflowSessionStarter(options: {
     getSessionId?: () => string;
     sessionId: string;
@@ -171,10 +242,5 @@ declare function createTileflowTransformRequest<TRequest extends TileflowTransfo
     transformRequest?: TileflowUserTransformRequest<TRequest, TResourceType>;
     worldRequestBridge?: TileflowWorldRequestBridge;
 }): TileflowTransformRequest<TRequest, TResourceType> | undefined;
-declare function createTileflowMarkerController<TMap, TDefinition, TMarker>(options: {
-    attach: (marker: TMarker, map: TMap, definition: TDefinition) => void;
-    create: (definition: TDefinition) => TMarker;
-    remove: (marker: TMarker) => void;
-}): TileflowMarkerController<TMap, TDefinition, TMarker>;
 
-export { type TileflowAsyncAnalyticsTiming, type TileflowComposedRequest, type TileflowContourProtocolHandler, type TileflowContourProtocolRegistrationOptions, type TileflowContourProtocolRegistry, type TileflowContourProtocolRequest, type TileflowContourProtocolResponse, type TileflowFairUseNotice, type TileflowFairUseNoticeController, type TileflowFairUseNoticeState, type TileflowFrameScheduler, type TileflowMapLifecycleAttachment, type TileflowMapLifecycleEvent, type TileflowMapLifecycleSubscriber, type TileflowMapReadinessState, type TileflowMarkerController, type TileflowSessionSender, type TileflowSessionStarter, type TileflowStyleFontLoadOptions, type TileflowStyleSwitchMap, type TileflowThemeController, type TileflowThemeTransition, type TileflowThemeTransitionPhase, type TileflowThemeTransitionResult, type TileflowTransformRequest, type TileflowTransformRequestParameters, type TileflowUserTransformRequest, type TileflowWorldProtocolHandler, type TileflowWorldProtocolRequest, type TileflowWorldProtocolResponse, type TileflowWorldRequestBridge, attachTileflowFairUseNotice, attachTileflowMapLifecycle, createTileflowMarkerController, createTileflowSessionStarter, createTileflowThemeController, createTileflowTransformRequest, getTileflowSystemColorScheme, loadTileflowStyleFonts, registerTileflowContourProtocol, registerTileflowWorldRequestBridge, subscribeTileflowSystemColorScheme, tileflowFairUseNoticeMessage, tileflowMaplibreContourVersion };
+export { type TileflowAsyncAnalyticsTiming, type TileflowComposedRequest, type TileflowContourProtocolHandler, type TileflowContourProtocolRegistrationOptions, type TileflowContourProtocolRegistry, type TileflowContourProtocolRequest, type TileflowContourProtocolResponse, type TileflowFairUseNotice, type TileflowFairUseNoticeController, type TileflowFairUseNoticeState, type TileflowFrameScheduler, type TileflowMapLifecycleAttachment, type TileflowMapLifecycleEvent, type TileflowMapLifecycleSubscriber, type TileflowMapReadinessState, type TileflowPmtilesProtocolHandler, type TileflowPmtilesProtocolRegistrationOptions, type TileflowPmtilesProtocolRegistry, type TileflowSessionSender, type TileflowSessionStarter, type TileflowStyleFontLoadOptions, type TileflowStyleSwitchMap, type TileflowThemeController, type TileflowThemeTransition, type TileflowThemeTransitionPhase, type TileflowThemeTransitionResult, type TileflowTransformRequest, type TileflowTransformRequestParameters, type TileflowUserTransformRequest, type TileflowWorldProtocolHandler, type TileflowWorldProtocolRequest, type TileflowWorldProtocolResponse, type TileflowWorldRequestBridge, attachTileflowFairUseNotice, attachTileflowMapLifecycle, createTileflowSessionStarter, createTileflowThemeController, createTileflowTransformRequest, getTileflowSystemColorScheme, loadTileflowStyleFonts, registerTileflowContourProtocol, registerTileflowPmtilesProtocol, registerTileflowWorldRequestBridge, subscribeTileflowSystemColorScheme, tileflowFairUseNoticeMessage, tileflowMaplibreContourVersion, tileflowPmtilesMaximumDirectoryDepth, tileflowPmtilesProtocol };