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

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,185 @@
+# Third-party notices
+
+`@tileflow/core/browser` embeds `maplibre-contour` 0.1.0 so contour rendering remains local and
+does not require executable code from a public CDN. The complete upstream license follows.
+
+## maplibre-contour 0.1.0
+
+BSD 3-Clause License
+
+Copyright (c) 2023, Michael Barry and maplibre-contour contributors
+
+Redistribution and use in source and binary forms, with or without modification, are permitted
+provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions
+   and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of
+   conditions and the following disclaimer in the documentation and/or other materials provided
+   with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to
+   endorse or promote products derived from this software without specific prior written
+   permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+Contains code from d3-contour <https://github.com/d3/d3-contour>
+
+Copyright 2012-2023 Mike Bostock
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee
+is hereby granted, provided that the above copyright notice and this permission notice appear in all
+copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
+SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
+NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
+OF THIS SOFTWARE.
+
+---
+
+Contains code from vt-pbf <https://github.com/mapbox/vt-pbf>
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Anand Thakker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+## pbf 4.0.1
+
+Copyright (c) 2024, Mapbox
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted
+provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions
+   and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of
+   conditions and the following disclaimer in the documentation and/or other materials provided
+   with the distribution.
+
+3. Neither the name of pbf nor the names of its contributors may be used to endorse or promote
+   products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+Contains code based on node-buffer-more-ints <https://github.com/dpw/node-buffer-more-ints>
+
+Copyright (c) 2012 David Wragg. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+Contains code from buffer <https://github.com/feross/buffer>
+
+The MIT License (MIT)
+
+Copyright (c) Feross Aboukhadijeh, and other contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Parts of this software are based on Node.js:
+
+Copyright Node.js contributors. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+See <https://github.com/nodejs/node/blob/main/LICENSE> for more information.
+
+---
+
+## TypeScript helper code
+
+The bundled browser entry retains TypeScript helper code and its complete upstream notice:
+
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee
+is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
+SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
+NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
+OF THIS SOFTWARE.

package/TRADEMARKS.md

@@ -0,0 +1,10 @@
+# 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.

package/dist/browser.d.ts

@@ -1,7 +1,101 @@
-import { T as TileflowAnalytics, a as TileflowSessionController } from './runtime-DroKDIuB.js';
+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 TileflowFairUseNotice = Readonly<{
+    action: string;
+    helpUrl: string;
+    message: string;
+    state: TileflowFairUseNoticeState;
+}>;
+type TileflowWorldProtocolRequest = Readonly<{
+    type?: string;
+    url: string;
+}>;
+type TileflowWorldProtocolResponse = Readonly<{
+    cacheControl?: string;
+    data: ArrayBuffer;
+    etag?: string;
+    expires?: string;
+}>;
+type TileflowWorldProtocolHandler = (request: TileflowWorldProtocolRequest, abortController: AbortController) => Promise<TileflowWorldProtocolResponse>;
+type TileflowWorldRequestBridge = Readonly<{
+    dispose: () => void;
+    rewriteUrl: (url: string) => string;
+}>;
+type TileflowFairUseNoticeController = Readonly<{
+    dispose: () => void;
+    update: (notice: TileflowFairUseNotice | null) => void;
+}>;
+declare function registerTileflowWorldRequestBridge(input: {
+    addProtocol: (name: string, handler: TileflowWorldProtocolHandler) => void;
+    fetch?: typeof fetch;
+    onNotice: (notice: TileflowFairUseNotice | null) => void;
+}): TileflowWorldRequestBridge;
+declare function tileflowFairUseNoticeMessage(state: TileflowFairUseNoticeState): string;
+declare function attachTileflowFairUseNotice(container: HTMLElement): TileflowFairUseNoticeController;
+
+declare const tileflowMaplibreContourVersion: "0.1.0";
+type TileflowContourProtocolRequest = Readonly<{
+    url: string;
+}>;
+type TileflowContourProtocolResponse = Readonly<{
+    cacheControl?: string | null;
+    data: ArrayBuffer;
+    expires?: Date | string | null;
+}>;
+type TileflowContourProtocolHandler = (request: TileflowContourProtocolRequest, abortController: AbortController) => Promise<TileflowContourProtocolResponse>;
+type TileflowContourProtocolRegistry = {
+    addProtocol: (name: string, handler: TileflowContourProtocolHandler) => void;
+};
+type TileflowContourProtocolRegistrationOptions = {
+    /** Test/integration override; the default lazily initializes the pinned, bundled module. */
+    loadMaplibreContour?: () => Promise<unknown>;
+};
+/** Registers the one self-contained protocol emitted by every compiled contour source. */
+declare function registerTileflowContourProtocol(registry: TileflowContourProtocolRegistry, options?: TileflowContourProtocolRegistrationOptions): void;
+
 type TileflowMapReadinessState = 'error' | 'idle' | 'loading';
+/** Read the browser preference without persisting or mutating user state. */
+declare function getTileflowSystemColorScheme(): TileflowRuntimeColorScheme;
+/**
+ * Subscribe through one process-wide `matchMedia` listener, regardless of adapter or map count.
+ */
+declare function subscribeTileflowSystemColorScheme(listener: (scheme: TileflowRuntimeColorScheme) => void): () => void;
+type TileflowThemeTransitionPhase = 'applying' | 'error' | 'preloading' | 'ready';
+type TileflowThemeTransition = Readonly<{
+    currentTheme?: string;
+    error?: Error;
+    phase: TileflowThemeTransitionPhase;
+    targetTheme?: string;
+}>;
+type TileflowThemeTransitionResult = Readonly<{
+    error?: Error;
+    status: 'applied' | 'failed' | 'superseded';
+    theme?: string;
+}>;
+type TileflowStyleSwitchMap = {
+    off(event: 'error' | 'style.load', listener: (event?: unknown) => void): unknown;
+    on(event: 'error' | 'style.load', listener: (event?: unknown) => void): unknown;
+    setStyle: unknown;
+};
+type TileflowThemeController = {
+    dispose(): void;
+    getCurrent(): TileflowRuntimeStyle;
+    setTheme(style: TileflowRuntimeStyle): Promise<TileflowThemeTransitionResult>;
+};
+/**
+ * Transactionally changes a MapLibre style while preserving the map instance and camera.
+ * Independent font preloads start immediately; style application is serialized and last request wins.
+ */
+declare function createTileflowThemeController(options: {
+    initial: TileflowRuntimeStyle;
+    loadFonts?: (style: TileflowRuntimeStyle) => Promise<void>;
+    map: TileflowStyleSwitchMap;
+    onTransition?: (transition: TileflowThemeTransition) => void;
+    timeoutMs?: number;
+}): TileflowThemeController;
 type TileflowMapLifecycleEvent = 'dataloading' | 'error' | 'idle' | 'load' | 'styledataloading';
 type TileflowFrameScheduler<TFrame> = {
     cancelFrame: (frame: TFrame) => void;
@@ -22,6 +116,13 @@ type TileflowMapLifecycleAttachment = {
     dispose: () => void;
     invalidate: (state?: TileflowMapReadinessState) => void;
 };
+type TileflowStyleFontLoadOptions = {
+    /** Already resolved manifest metadata. An explicit empty array avoids fetching the style. */
+    fontFaces?: readonly TileflowStyleFontFace[];
+    fetch?: typeof globalThis.fetch;
+};
+/** Loads content-addressed style font faces before MapLibre starts shaping labels. */
+declare function loadTileflowStyleFonts(style: MapLibreStyle | string, options?: TileflowStyleFontLoadOptions): Promise<void>;
 type TileflowTransformRequestParameters = {
     url: string;
 };
@@ -59,6 +160,7 @@ declare function createTileflowTransformRequest<TRequest extends TileflowTransfo
     sessionController?: TileflowSessionController;
     sessionId: string;
     transformRequest?: TileflowUserTransformRequest<TRequest, TResourceType>;
+    worldRequestBridge?: TileflowWorldRequestBridge;
 }): TileflowTransformRequest<TRequest, TResourceType>;
 declare function createTileflowTransformRequest<TRequest extends TileflowTransformRequestParameters = TileflowTransformRequestParameters, TResourceType = unknown>(options: {
     always?: boolean;
@@ -67,6 +169,7 @@ declare function createTileflowTransformRequest<TRequest extends TileflowTransfo
     sessionController?: TileflowSessionController;
     sessionId: string;
     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;
@@ -74,4 +177,4 @@ declare function createTileflowMarkerController<TMap, TDefinition, TMarker>(opti
     remove: (marker: TMarker) => void;
 }): TileflowMarkerController<TMap, TDefinition, TMarker>;
 
-export { type TileflowAsyncAnalyticsTiming, type TileflowComposedRequest, type TileflowFrameScheduler, type TileflowMapLifecycleAttachment, type TileflowMapLifecycleEvent, type TileflowMapLifecycleSubscriber, type TileflowMapReadinessState, type TileflowMarkerController, type TileflowSessionSender, type TileflowSessionStarter, type TileflowTransformRequest, type TileflowTransformRequestParameters, type TileflowUserTransformRequest, attachTileflowMapLifecycle, createTileflowMarkerController, createTileflowSessionStarter, createTileflowTransformRequest };
+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 };