@tileflow/dev 0.1.0-alpha.4 → 0.1.0-alpha.40

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,309 @@
+# Third-party notices
+
+This file records third-party components used by Node preparation and preview. Official map artwork
+and fonts are owned and published by `@tileflow/maps`; `@tileflow/dev` does not carry an `assets/`
+directory. Inspector interface fonts are distributed separately under `ui-fonts/`. Node runtime dependencies are installed as separate npm packages. The browser inspector bundles
+the evaluator and decoders described below; native binaries are not copied into the dev package.
+
+## Inspector interface fonts
+
+Inter by Rasmus Andersson and JetBrains Mono by JetBrains are distributed under the SIL Open Font License 1.1. Their complete notices accompany the WOFF2 files in `ui-fonts/inter-OFL.txt` and `ui-fonts/jetbrains-mono-OFL.txt`. Source: <https://github.com/rsms/inter> and <https://github.com/JetBrains/JetBrainsMono>.
+
+Mona Sans and Hubot Sans by GitHub are distributed under the SIL Open Font License 1.1.
+Their complete notices accompany the WOFF2 files in `ui-fonts/mona-sans-OFL.txt` and
+`ui-fonts/hubot-sans-OFL.txt`. These fonts style the development interface and do not alter map text.
+
+## Bitmap distance transform
+
+`src/icon-distance.ts` adapts the alpha distance transform from bitmap-sdf 1.0.4 for bounded,
+Node-only sprite preparation. The adaptation removes browser globals and adds input validation.
+Source: <https://github.com/dy/bitmap-sdf>. License: MIT.
+
+Copyright 2020 Dmitry Ivanov
+
+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.
+
+## Package-owned map fonts
+
+The generic font preparation pipeline reads map-owned TTF, OTF, and WOFF2 directories; it does not
+embed map fonts in `@tileflow/dev`. Each source directory must carry its own `LICENSE.txt`, which is
+copied into the deterministic build artifacts whenever that directory contributes a selected face.
+
+The source repository's generic font tests retain pinned Oxanium fixtures and their complete
+SIL Open Font License 1.1 notice under `test/fixtures/fonts/oxanium/`. These fixtures are not
+included in the published package. Community map fonts are owned by
+[Community Maps](https://github.com/tileflow/community-maps).
+
+## fontkit 2.0.4
+
+Font metadata for TTF, OTF, and WOFF2 inputs is read with the separately installed `fontkit`
+package. fontkit is copyright Devon Govett and contributors and is distributed under the MIT
+License.
+
+- Source: <https://github.com/foliojs/fontkit/tree/v2.0.4>
+- License: <https://github.com/foliojs/fontkit/blob/v2.0.4/LICENSE>
+
+## PMTiles JavaScript 4.5.0
+
+Local tileset inspection uses the separately installed `pmtiles` package to read vector and raster
+tiles from local PMTiles archives. PMTiles is copyright Protomaps and
+contributors and is distributed under the BSD 3-Clause License. Its `fflate` dependency is
+copyright 2020 Arjun Barrett and is distributed under the MIT License.
+
+- PMTiles source and license: <https://github.com/protomaps/PMTiles/tree/v4.5.0/js>
+- fflate source and license: <https://github.com/101arrowz/fflate/tree/v0.8.3>
+
+## sharp 0.35.5
+
+`@tileflow/dev` declares `sharp` as an optional dependency and loads it dynamically only when local
+SVG or raster icon sources must be inspected and packed. The Tileflow build externalizes `sharp`
+rather than bundling it. `sharp` is copyright Lovell Fuller and contributors and is distributed under
+the Apache License 2.0.
+
+- Source: <https://github.com/lovell/sharp/tree/v0.35.5>
+- License: <https://github.com/lovell/sharp/blob/v0.35.5/LICENSE>
+
+## sharp libvips distributions 1.3.4
+
+`sharp` selects a separate optional `@img/sharp-libvips-*` package for the current platform. The
+installed platform-package manifest declares `LGPL-3.0-or-later`; the packaging scripts themselves
+are distributed under Apache-2.0. The packages contain prebuilt libvips and separately licensed
+runtime dependencies. For `sharp` 0.35.5 the selected libvips ABI is 8.18.7.
+
+- Packaging source: <https://github.com/lovell/sharp-libvips/tree/v1.3.4>
+- Packaging-script license: <https://github.com/lovell/sharp-libvips/blob/v1.3.4/LICENSE>
+- libvips 8.18.7 source: <https://github.com/libvips/libvips/tree/v8.18.7>
+- libvips 8.18.7 license (LGPL-2.1-or-later):
+  <https://github.com/libvips/libvips/blob/v8.18.7/LICENSE>
+
+Because `sharp` remains a separately installed optional package, users can install, update, remove,
+or replace it independently of `@tileflow/dev`. Tileflow does not modify libvips and does not place a
+libvips shared library or a `sharp` native addon inside any Tileflow package tarball. Release smoke
+tests enforce that package boundary.
+
+## MapLibre style specification 24.8.5
+
+The Inspector browser bundle includes the expression evaluator and reference from
+`@maplibre/maplibre-gl-style-spec` 24.8.5. The following is the complete upstream `LICENSE.txt`,
+including its notices for incorporated code.
+
+Source: <https://github.com/maplibre/maplibre-style-spec/tree/v24.8.5>.
+
+```text
+Copyright (c) 2020, MapLibre contributors
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of MapLibre GL JS 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 OWNER 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 mapbox-gl-js v1.13 and earlier
+
+Version v1.13 of mapbox-gl-js and earlier are licensed under a BSD-3-Clause license
+
+Copyright (c) 2020, Mapbox
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+* 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.
+* Neither the name of Mapbox GL JS 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 OWNER 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 glfx.js
+
+Copyright (C) 2011 by Evan Wallace
+
+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 a portion of d3-color https://github.com/d3/d3-color
+
+Copyright 2010-2016 Mike Bostock
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* 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.
+
+* Neither the name of the author nor the names of 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 OWNER 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.
+```
+
+## pbf 5.1.2
+
+The Inspector browser bundle includes the PBF reader to preview map font glyphs.
+Source: <https://github.com/mapbox/pbf/tree/v5.1.2>.
+
+```text
+Copyright (c) 2026, 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:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* 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.
+
+* 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.
+```
+
+## @mapbox/vector-tile 3.0.0
+
+The browser tile inspector bundles this MVT decoder to inspect resident vector tiles.
+Source: <https://github.com/mapbox/vector-tile-js/tree/v3.0.0>. License: BSD 3-Clause.
+
+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:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of Mapbox 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 OWNER 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.
+
+## @mapbox/point-geometry 1.1.0
+
+Bundled with the vector-tile decoder for feature geometry.
+Source: <https://github.com/mapbox/point-geometry/tree/v1.1.0>. License: ISC.
+
+Copyright (c) 2024, Mapbox
+
+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.

package/dist/artifacts.d.ts

@@ -0,0 +1,269 @@
+import { MapLibreStyle, TileflowViewConfig, TileflowStyleOptions } from '@tileflow/core';
+export { TileflowLandmarkFootprint, readTileflowLandmarkTileFootprints, tileflowLandmarkRegionOf, tileflowLandmarkRegionZoom, tileflowLandmarkTileOf, tileflowLandmarkTileZoom } from '@tileflow/core';
+import { TileflowBuildCatalog, TileflowBuildStyles, TileflowMapBuildManifestV1, TileflowRendererDeploymentArtifact, TileflowPreparedMapAssets, TileflowStyleInspection, TileflowMapBuildProvenanceV1 } from '@tileflow/core/build';
+import { TileflowRuntimeManifest } from '@tileflow/core/manifest';
+import { TileflowRenderer, TileflowNativeBuildRecord } from '@tileflow/core/native-profile';
+import { T as TileflowBuildAsset, a as TileflowIconResolutionOptions, P as PreparedTileflowBuildCatalog, b as TileflowSourceCatalog, c as PreparedTileflowCatalog } from './icons-BIHpw5Zy.js';
+export { d as TileflowBuildingModelLevels, e as TileflowLandmarkSource, f as encodeTileflowLandmarkRegion, p as packageTileflowLandmarkTile, g as prepareTileflowBuildingModel } from './icons-BIHpw5Zy.js';
+export { defaultTileflowConfigPath } from './config.js';
+
+/**
+ * Local glyph serving for line-fitted text backgrounds.
+ *
+ * A style whose text uses a derived `<stack> lines-v1-…` font stack needs a glyph provider that
+ * derives those ranges. Local previews and captures route such a map's glyph URL through
+ * `__glyphs/<map>/…`: ordinary stacks pass through from the map's declared provider unchanged, and
+ * derived stacks are computed from their source stack's range. Production output keeps the
+ * declared provider, which must serve derived stacks itself.
+ */
+declare const tileflowLineBackgroundGlyphRoute = "__glyphs";
+/** Map name to the upstream glyph URL template its styles declared. Local only; never serialized. */
+type TileflowLineBackgroundGlyphProviders = Readonly<Record<string, string>>;
+type TileflowLineBackgroundGlyphResponderOptions = {
+    /** Project root; ranges are cached under `.tileflow/cache/glyphs/v1`. */
+    cwd: string;
+    fetch?: typeof globalThis.fetch;
+};
+type TileflowLineBackgroundGlyphResponder = (upstream: string, fontStack: string, range: string) => Promise<Response>;
+/** Whether a compiled style draws text with a derived line-background stack. */
+declare function usesTileflowLineBackgroundGlyphs(style: MapLibreStyle): boolean;
+/** Parses `/__glyphs/<map>/<fontstack>/<range>.pbf` from a decoded route path. */
+declare function parseTileflowLineBackgroundGlyphPath(path: string): {
+    fontStack: string;
+    mapName: string;
+    range: string;
+} | undefined;
+/**
+ * Serves one glyph range for a declared upstream template. Upstream ranges are cached on disk;
+ * derived ranges are recomputed from them and kept in a bounded in-memory cache.
+ */
+declare function createTileflowLineBackgroundGlyphResponder(options: TileflowLineBackgroundGlyphResponderOptions): TileflowLineBackgroundGlyphResponder;
+
+type TileflowLocalTilesetFile = Readonly<{
+    byteLength: number;
+    etag: string;
+    fileName: string;
+    logicalId: string;
+    sourcePath: string;
+}>;
+declare function prepareTileflowLocalTilesets(project: TileflowBuildCatalog, styles: TileflowBuildStyles, options: {
+    assetBaseUrl: string;
+    baseDirectory: string;
+    cwd: string;
+}): Promise<{
+    dispose(): Promise<void>;
+    files: TileflowLocalTilesetFile[];
+    styles: TileflowBuildStyles;
+    watchPaths: string[];
+}>;
+
+declare const tileflowArtifactSessionSchemaVersion: 1;
+type TileflowArtifactDiagnostic = {
+    code?: string;
+    message: string;
+    path: string;
+    phase?: string;
+    renderer?: 'native';
+    profile?: 'native-v1';
+    severity?: 'error';
+    suggestion?: string;
+};
+type TileflowArtifactSessionState = {
+    status: 'building';
+    generation: number;
+    lastGoodGeneration?: number;
+} | {
+    status: 'ready';
+    generation: number;
+    artifacts: TileflowBuildArtifacts;
+    lastGoodGeneration: number;
+} | {
+    status: 'invalid';
+    generation: number;
+    diagnostics: TileflowArtifactDiagnostic[];
+    lastGoodGeneration?: number;
+};
+type TileflowArtifactSessionOptions = TileflowBuildArtifactsOptions & {
+    debounceMs?: number;
+    ignoredPaths?: string[];
+    watch?: boolean;
+};
+type TileflowArtifactAcquisition = Readonly<{
+    artifacts: TileflowBuildArtifacts;
+    generation: number;
+    release(): Promise<void>;
+}>;
+type TileflowArtifactSession = {
+    /** Pins the current generation for asynchronous work; the caller must release it. */
+    acquireArtifacts(generation?: number): TileflowArtifactAcquisition | undefined;
+    close(): Promise<void>;
+    /** Borrowed synchronous view. Use acquireArtifacts() before retaining it across an await. */
+    getLastGoodArtifacts(): TileflowBuildArtifacts | undefined;
+    /** Ready-state artifacts are a borrowed synchronous view. */
+    getState(): TileflowArtifactSessionState;
+    refresh(reason?: string): Promise<void>;
+    subscribe(listener: (state: TileflowArtifactSessionState) => void): () => void;
+};
+declare function createTileflowArtifactDiagnostics(error: unknown, cwd: string): TileflowArtifactDiagnostic[];
+
+type Input = Readonly<{
+    mapId: string;
+    buildManifest: TileflowMapBuildManifestV1;
+    styles: Readonly<Record<string, MapLibreStyle>>;
+    teamSources: Readonly<Record<string, Readonly<{
+        tileset: string;
+        type: 'raster' | 'vector';
+    }>>>;
+    assets: readonly TileflowBuildAsset[];
+    view?: TileflowViewConfig;
+}>;
+/**
+ * Prepare both representations from the same already compiled, asset-bound web family.
+ * This has no network or publication port. Call it before any authenticated remote operation.
+ * Logical Hosted placeholders are validated syntactically without granting delivery authority.
+ */
+declare function prepareTileflowHostedNativeDeployment(input: Input): Promise<TileflowRendererDeploymentArtifact>;
+
+/** Normalize a development route base. This is a URL pathname, never a filesystem path. */
+declare function normalizeTileflowBasePath(value?: string): string;
+/**
+ * Join a bundler public URL prefix to the Tileflow route without changing URL-reference kind.
+ * In particular, `./` and `../` remain path-relative rather than becoming root-relative.
+ */
+declare function joinTileflowPublicUrl(publicBase: string, basePath: string): string;
+/**
+ * Resolve the public URL at which a manifest is exposed and the URLs embedded inside its artifacts.
+ * Path-relative deployments use owner-relative references because the manifest already lives below
+ * the public prefix.
+ */
+declare function resolveTileflowArtifactPublicUrls(publicBase: string, basePath: string): {
+    assetBaseUrl?: string;
+    publicBaseUrl: string;
+    styleBaseUrl: string;
+};
+/** Convert a validated route base to a bundler-relative asset prefix. */
+declare function getTileflowAssetBasePath(basePath: string): string;
+declare function getTileflowAssetFileName(basePath: string, fileName: string): string;
+
+declare const tileflowArtifactPlanSchemaVersion: 1;
+declare const tileflowArtifactInventoryFileName = ".tileflow-artifacts.json";
+type TileflowManifestOptions = {
+    styleBaseUrl?: string;
+};
+type TileflowBuildArtifactsOptions = {
+    apiBaseUrl?: string;
+    assetBaseUrl?: string;
+    config?: string;
+    cwd?: string;
+    /**
+     * Native local preview only: the exact HTTP origin serving these artifacts, such as
+     * `http://127.0.0.1:3333`. Native checks accept HTTP resources at this origin only; every other
+     * origin still requires HTTPS. It is never inferred, and web or production output rejects it.
+     */
+    developmentOrigin?: string;
+    /**
+     * Explicit shared Icon Set resolution settings for this build.
+     *
+     * Builds never resolve a catalog head. These options only choose the verified cache root,
+     * offline behavior, trusted delivery origins and the transport used to hydrate exact pins.
+     */
+    icons?: TileflowIconResolutionOptions;
+    /** Artifact renderer. Omission is identical to web; native uses a separate output directory. */
+    renderer?: TileflowRenderer;
+    /** Build a memory-only compiler sidecar for local authoring tools. */
+    inspection?: boolean;
+    styleBaseUrl?: string;
+    /** Local tools may snapshot local PMTiles; production output must resolve them explicitly. */
+    target?: 'local' | 'production';
+};
+type TileflowBuildStyleInspections = Record<string, Record<string, TileflowStyleInspection>>;
+/** Compatibility shape consumed by sessions and capture callers. */
+type TileflowBuildArtifacts = {
+    /** Local-only prepared handles used to recompile module controls without resolving assets again. */
+    mapAssets?: Readonly<Record<string, TileflowPreparedMapAssets>>;
+    assets: TileflowBuildAsset[];
+    buildManifest: TileflowMapBuildManifestV1;
+    /** Present only for native artifact preparation; never part of the runtime manifest. */
+    nativeBuild?: TileflowNativeBuildRecord;
+    /** Releases local immutable snapshot references owned by this artifact generation. */
+    dispose?: () => Promise<void>;
+    manifest: TileflowRuntimeManifest;
+    project: TileflowBuildCatalog;
+    /** Local-only archive ports. Paths never enter serialized build artifacts. */
+    localTilesets?: TileflowLocalTilesetFile[];
+    /** Local-only upstream glyph templates for maps whose text uses line-fitted backgrounds. */
+    lineBackgroundGlyphs?: TileflowLineBackgroundGlyphProviders;
+    /** Optional local-only provenance. It is never serialized as a build artifact. */
+    styleInspections?: TileflowBuildStyleInspections;
+    styles: TileflowBuildStyles;
+    watchPaths: string[];
+};
+type TileflowArtifactFile = TileflowBuildAsset;
+type TileflowArtifactInputGraph = {
+    /** Exact executable config modules and data files observed during evaluation. */
+    files: string[];
+    /** Asset directories whose children can change without changing the config module. */
+    directories: string[];
+};
+/**
+ * Complete, deterministic output of compiling one prepared source generation.
+ * `sourceProject` is retained for diagnostics only; `project` is the portable runtime input.
+ */
+type TileflowArtifactPlan = TileflowBuildArtifacts & {
+    files: TileflowArtifactFile[];
+    inputs: TileflowArtifactInputGraph;
+    project: PreparedTileflowBuildCatalog;
+    schemaVersion: typeof tileflowArtifactPlanSchemaVersion;
+    sourceProject: TileflowSourceCatalog;
+};
+type CreateTileflowArtifactPlanOptions = Pick<TileflowBuildArtifactsOptions, 'apiBaseUrl' | 'assetBaseUrl' | 'developmentOrigin' | 'inspection' | 'renderer' | 'styleBaseUrl' | 'target'> & {
+    inputFiles?: readonly string[];
+};
+type WriteTileflowArtifactPlanOptions = {
+    cwd?: string;
+    outDir: string;
+    /** Explicit escape hatch for replacing a Hosted delivery manifest with self-hosted artifacts. */
+    overwriteHostedManifest?: boolean;
+};
+type WriteTileflowBuildArtifactsOptions = TileflowBuildArtifactsOptions & WriteTileflowArtifactPlanOptions;
+declare class TileflowHostedManifestOverwriteError extends Error {
+    readonly code: "HOSTED_MANIFEST_OVERWRITE_REFUSED";
+    constructor(path: string);
+}
+declare class TileflowLocalTilesetProductionError extends Error {
+    readonly code: "TF_LOCAL_TILESET_PRODUCTION_UNRESOLVED";
+    constructor();
+}
+declare function createTileflowManifest(project: TileflowBuildCatalog, options?: TileflowManifestOptions): TileflowRuntimeManifest;
+declare function createTileflowStyle(project: TileflowBuildCatalog, mapName: string, options?: TileflowStyleOptions): MapLibreStyle;
+declare function createTileflowStyles(project: TileflowBuildCatalog, options?: Omit<TileflowStyleOptions, 'preparedAssets' | 'theme'> & {
+    mapAssets?: Readonly<Record<string, TileflowPreparedMapAssets>>;
+}): TileflowBuildStyles;
+/** Compiles only a prepared project, keeping local source resolution out of core compilation. */
+declare function createTileflowArtifactPlan(prepared: PreparedTileflowCatalog, options?: CreateTileflowArtifactPlanOptions): Promise<TileflowArtifactPlan>;
+declare function createTileflowBuildArtifacts(options?: TileflowBuildArtifactsOptions): Promise<TileflowArtifactPlan>;
+declare function getTileflowArtifactFiles(artifacts: TileflowBuildArtifacts): TileflowArtifactFile[];
+/** Resolve portable build provenance without making it part of any map authoring revision. */
+declare function createTileflowBuildProvenance(cwd: string): Promise<TileflowMapBuildProvenanceV1>;
+declare function createTileflowArtifactSession(options?: TileflowArtifactSessionOptions): Promise<TileflowArtifactSession>;
+declare function getTileflowWatchPaths(options?: Pick<TileflowBuildArtifactsOptions, 'config' | 'cwd'>): Promise<string[]>;
+declare function isTileflowArtifactInputPath(inputs: TileflowArtifactInputGraph, path: string): boolean;
+/** Shared refresh gate for adapters that receive filesystem or framework lifecycle events. */
+declare function refreshTileflowArtifactSession(session: TileflowArtifactSession, options: {
+    inputPath?: string;
+    reason: string;
+}): Promise<boolean>;
+declare function writeTileflowBuildArtifacts(options: WriteTileflowBuildArtifactsOptions): Promise<TileflowArtifactPlan>;
+declare function disposeTileflowBuildArtifacts(artifacts: Pick<TileflowBuildArtifacts, 'dispose'>): Promise<void>;
+/**
+ * Replaces one managed artifact generation and records its exact file inventory. Unmanaged files
+ * are never scanned or removed. A caught filesystem failure restores every previous managed file.
+ */
+declare function writeTileflowArtifactPlan(artifacts: TileflowArtifactPlan, options: WriteTileflowArtifactPlanOptions): Promise<void>;
+declare function assertNoLocalTilesetsForProduction(artifacts: Pick<TileflowBuildArtifacts, 'localTilesets'>): void;
+/** Prevents a framework build from silently replacing the frontend's Hosted delivery contract. */
+declare function assertTileflowSelfHostedManifestTarget(manifestPath: string, options?: {
+    overwriteHostedManifest?: boolean;
+}): Promise<void>;
+
+export { type CreateTileflowArtifactPlanOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, type TileflowArtifactAcquisition, type TileflowArtifactDiagnostic, type TileflowArtifactFile, type TileflowArtifactInputGraph, type TileflowArtifactPlan, type TileflowArtifactSession, type TileflowArtifactSessionOptions, type TileflowArtifactSessionState, type TileflowBuildArtifacts, type TileflowBuildArtifactsOptions, TileflowBuildAsset, type TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, TileflowIconResolutionOptions, type TileflowLineBackgroundGlyphProviders, type TileflowLineBackgroundGlyphResponder, type TileflowLocalTilesetFile, TileflowLocalTilesetProductionError, type TileflowManifestOptions, TileflowSourceCatalog, type WriteTileflowArtifactPlanOptions, type WriteTileflowBuildArtifactsOptions, assertNoLocalTilesetsForProduction, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowLineBackgroundGlyphResponder, createTileflowManifest, createTileflowStyle, createTileflowStyles, disposeTileflowBuildArtifacts, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, parseTileflowLineBackgroundGlyphPath, prepareTileflowHostedNativeDeployment, prepareTileflowLocalTilesets, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, tileflowLineBackgroundGlyphRoute, usesTileflowLineBackgroundGlyphs, writeTileflowArtifactPlan, writeTileflowBuildArtifacts };

package/dist/artifacts.js

@@ -0,0 +1,98 @@
+import {
+  TileflowHostedManifestOverwriteError,
+  TileflowLocalTilesetProductionError,
+  assertNoLocalTilesetsForProduction,
+  assertTileflowSelfHostedManifestTarget,
+  createTileflowArtifactDiagnostics,
+  createTileflowArtifactPlan,
+  createTileflowArtifactSession,
+  createTileflowBuildArtifacts,
+  createTileflowBuildProvenance,
+  createTileflowLineBackgroundGlyphResponder,
+  createTileflowManifest,
+  createTileflowStyle,
+  createTileflowStyles,
+  disposeTileflowBuildArtifacts,
+  getTileflowArtifactFiles,
+  getTileflowWatchPaths,
+  isTileflowArtifactInputPath,
+  parseTileflowLineBackgroundGlyphPath,
+  prepareTileflowHostedNativeDeployment,
+  prepareTileflowLocalTilesets,
+  readTileflowLandmarkTileFootprints,
+  refreshTileflowArtifactSession,
+  tileflowArtifactInventoryFileName,
+  tileflowArtifactPlanSchemaVersion,
+  tileflowArtifactSessionSchemaVersion,
+  tileflowLandmarkRegionOf,
+  tileflowLandmarkRegionZoom,
+  tileflowLandmarkTileOf,
+  tileflowLandmarkTileZoom,
+  tileflowLineBackgroundGlyphRoute,
+  usesTileflowLineBackgroundGlyphs,
+  writeTileflowArtifactPlan,
+  writeTileflowBuildArtifacts
+} from "./chunk-AVJMTXW5.js";
+import {
+  getTileflowAssetBasePath,
+  getTileflowAssetFileName,
+  joinTileflowPublicUrl,
+  normalizeTileflowBasePath,
+  resolveTileflowArtifactPublicUrls
+} from "./chunk-FOMTSCOP.js";
+import {
+  encodeTileflowLandmarkRegion,
+  packageTileflowLandmarkTile,
+  prepareTileflowBuildingModel
+} from "./chunk-C4VPHZ3F.js";
+import "./chunk-RTU7TD4M.js";
+import "./chunk-KDFTE4Q5.js";
+import {
+  defaultTileflowConfigPath
+} from "./chunk-AQUGMUZW.js";
+import "./chunk-D4OE4ITL.js";
+import "./chunk-ONYQNLNA.js";
+export {
+  TileflowHostedManifestOverwriteError,
+  TileflowLocalTilesetProductionError,
+  assertNoLocalTilesetsForProduction,
+  assertTileflowSelfHostedManifestTarget,
+  createTileflowArtifactDiagnostics,
+  createTileflowArtifactPlan,
+  createTileflowArtifactSession,
+  createTileflowBuildArtifacts,
+  createTileflowBuildProvenance,
+  createTileflowLineBackgroundGlyphResponder,
+  createTileflowManifest,
+  createTileflowStyle,
+  createTileflowStyles,
+  defaultTileflowConfigPath,
+  disposeTileflowBuildArtifacts,
+  encodeTileflowLandmarkRegion,
+  getTileflowArtifactFiles,
+  getTileflowAssetBasePath,
+  getTileflowAssetFileName,
+  getTileflowWatchPaths,
+  isTileflowArtifactInputPath,
+  joinTileflowPublicUrl,
+  normalizeTileflowBasePath,
+  packageTileflowLandmarkTile,
+  parseTileflowLineBackgroundGlyphPath,
+  prepareTileflowBuildingModel,
+  prepareTileflowHostedNativeDeployment,
+  prepareTileflowLocalTilesets,
+  readTileflowLandmarkTileFootprints,
+  refreshTileflowArtifactSession,
+  resolveTileflowArtifactPublicUrls,
+  tileflowArtifactInventoryFileName,
+  tileflowArtifactPlanSchemaVersion,
+  tileflowArtifactSessionSchemaVersion,
+  tileflowLandmarkRegionOf,
+  tileflowLandmarkRegionZoom,
+  tileflowLandmarkTileOf,
+  tileflowLandmarkTileZoom,
+  tileflowLineBackgroundGlyphRoute,
+  usesTileflowLineBackgroundGlyphs,
+  writeTileflowArtifactPlan,
+  writeTileflowBuildArtifacts
+};