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

package/dist/index.d.ts

@@ -1,172 +1,300 @@
-type TileflowDensity = 'clean' | 'balanced' | 'dense';
-type TileflowRoads = 'hidden' | 'soft' | 'standard' | 'detailed';
-type TileflowLabels = 'none' | 'essential' | 'balanced' | 'full';
-type TileflowPoi = 'none' | 'minimal' | 'balanced' | 'full';
-type TileflowTheme = 'standard' | 'light' | 'dark' | 'minimal' | 'osm-bright-2';
-type TileflowBuildings = 'hidden' | 'flat' | '3d';
-type TileflowTerrainMode = 'none' | 'hillshade' | '3d';
-type TileflowTerrainEncoding = 'mapbox' | 'terrarium';
-type TileflowThemeMode = 'light' | 'dark';
-type TileflowColors = {
-    canvas: string;
-    land: string;
-    water: string;
-    nature: string;
-    road: string;
-    text: string;
-    accent: string;
-};
-type LegacyTileflowColorAliases = {
-    background?: string;
-    park?: string;
-    building?: string;
-    roadCasing?: string;
-};
-type TileflowColorConfig = Partial<TileflowColors> & LegacyTileflowColorAliases;
-type TileflowFontWeight = 'regular' | 'medium' | 'semibold' | 'bold';
-type TileflowTypography = {
-    font?: string;
-    weight?: TileflowFontWeight;
-};
-type TileflowThemeConfig = {
-    mode?: TileflowThemeMode;
-    colors?: TileflowColorConfig;
-    typography?: TileflowTypography;
-};
-type TileflowSourceLayers = {
-    landuse?: string;
-    park?: string;
-    water?: string;
-    road?: string;
-    building?: string;
-    boundary?: string;
-    place?: string;
-    poi?: string;
-};
-type TileflowTiles = {
-    sourceId?: string;
-    tileset?: string;
-    url?: string;
-    attribution?: string;
-    sourceLayers?: TileflowSourceLayers;
-};
-type TileflowTerrainConfig = {
-    attribution?: string;
-    encoding?: TileflowTerrainEncoding;
-    exaggeration?: number;
-    mode?: TileflowTerrainMode;
-    sourceId?: string;
-    tileset?: string;
-    url?: string;
-};
-type TileflowTerrain = TileflowTerrainMode | TileflowTerrainConfig;
-type TileflowViewConfig = {
-    bearing?: number;
-    center?: readonly [number, number];
-    zoom?: number;
-};
-type TileflowOsmBasemapConfig = {
-    type: 'osm';
-    attribution?: string;
-    glyphs?: string;
-    sourceId?: string;
-    sourceLayers?: TileflowSourceLayers;
-    sprite?: string;
-    tileset?: string;
-    url?: string;
-};
-type TileflowBasemapConfig = TileflowOsmBasemapConfig;
-type TileflowOsmBasemapOptions = Omit<TileflowOsmBasemapConfig, 'type'>;
-type TileflowRoadsModulePreset = 'modern' | 'minimal';
-type TileflowRoadsModuleConfig = {
-    type: 'roads';
-    density?: TileflowDensity;
-    preset?: TileflowRoadsModulePreset;
-};
-type TileflowRoadsModuleOptions = Omit<TileflowRoadsModuleConfig, 'type'>;
-type TileflowModuleConfig = TileflowRoadsModuleConfig;
-type TileflowConfig = {
-    basemap?: TileflowBasemapConfig;
-    name?: string;
-    tileset?: string;
-    theme?: TileflowTheme | string | TileflowThemeConfig;
-    modules?: readonly TileflowModuleConfig[];
-    colors?: TileflowColorConfig;
-    typography?: TileflowTypography;
-    density?: TileflowDensity;
-    roads?: TileflowRoads;
-    labels?: TileflowLabels;
-    poi?: TileflowPoi;
-    buildings?: TileflowBuildings;
-    terrain?: TileflowTerrain;
-    glyphs?: string;
-    sprite?: string;
-    tiles?: TileflowTiles;
-    view?: TileflowViewConfig;
-    /**
-     * Domains allowed to load this map in production (e.g. "example.com" or
-     * "*.example.com"). When set, tile and session requests from other
-     * websites are rejected. Local development (localhost, private network
-     * addresses) is always allowed. Leave unset to allow any domain.
-     */
-    allowedOrigins?: string[];
-};
-type TileflowMapConfig = TileflowConfig;
-type TileflowTilesetConfig = {
-    id?: string;
-    name?: string;
-    attribution?: string;
-    sourceLayers?: TileflowSourceLayers;
-};
-type TileflowProjectConfig = {
-    themes?: Record<string, TileflowThemeConfig>;
-    tilesets?: Record<string, TileflowTilesetConfig>;
-    maps: Record<string, TileflowMapConfig>;
+import { b as TileflowBaseColors, c as TileflowConfig, d as TileflowProjectConfig, V as ValidationResult, e as TileflowRoadsModuleOptions, f as TileflowRoadsModuleConfig, g as TileflowLabelsModuleOptions, h as TileflowLabelsModuleConfig, i as TileflowPoiModuleOptions, j as TileflowPoiModuleConfig } from './runtime-DroKDIuB.js';
+export { M as MapLibreSprite, k as MapLibreStyle, N as NormalizedTileflowCaptureScene, O as OpenMapTilesFieldBindings, l as OpenMapTilesLayerBindings, m as OpenMapTilesSchema, n as OpenMapTilesSchemaOptions, R as ResolvedTileflowData, o as ResolvedTileflowTypography, p as TileflowAerowaysModuleConfig, q as TileflowAerowaysModuleOptions, r as TileflowAlignment, T as TileflowAnalytics, s as TileflowAreaStyle, t as TileflowBackgroundPaint, u as TileflowBackgroundStyle, v as TileflowBoundariesModuleConfig, w as TileflowBoundariesModuleOptions, x as TileflowBoundaryColorConfig, y as TileflowBuildingColorConfig, z as TileflowBuildingMode, A as TileflowBuildingsModuleConfig, B as TileflowBuildingsModuleOptions, C as TileflowCaptureApplicationTarget, D as TileflowCaptureBoundsCamera, E as TileflowCaptureCamera, F as TileflowCaptureCenterCamera, G as TileflowCaptureMapTarget, H as TileflowCaptureScene, I as TileflowCaptureTarget, J as TileflowCaptureViewport, K as TileflowCirclePaint, L as TileflowCircleStyle, P as TileflowColor, Q as TileflowColorConfig, S as TileflowColors, U as TileflowDataConfig, W as TileflowDataIdentity, X as TileflowExpression, Y as TileflowExtrusionPaint, Z as TileflowExtrusionStyle, _ as TileflowFillPaint, $ as TileflowFillStyle, a0 as TileflowFilterExpression, a1 as TileflowFontWeight, a2 as TileflowHostedNotoSansWeight, a3 as TileflowHydroColorConfig, a4 as TileflowIconAnchor, a5 as TileflowIconLayout, a6 as TileflowIconPaint, a7 as TileflowIconSet, a8 as TileflowIconSetConfig, a9 as TileflowIconStyle, aa as TileflowLabelColorConfig, ab as TileflowLabelDetail, ac as TileflowLabelLanguage, ad as TileflowLabelStyles, ae as TileflowLandModuleConfig, af as TileflowLandModuleOptions, ag as TileflowLandcoverClass, ah as TileflowLandcoverColorConfig, ai as TileflowLanduseClass, aj as TileflowLanduseColorConfig, ak as TileflowLayerPlacement, al as TileflowLayerRange, am as TileflowLineCap, an as TileflowLineHatchStyle, ao as TileflowLineJoin, ap as TileflowLineLayout, aq as TileflowLinePaint, ar as TileflowLineStackStyle, as as TileflowLineStyle, at as TileflowManifest, au as TileflowManifestLoadOptions, av as TileflowMapConfig, aw as TileflowMapMarker, ax as TileflowMapMode, ay as TileflowMapModeOptions, az as TileflowMountainBikeScale, aA as TileflowPlaceLabelClass, aB as TileflowPoi, aC as TileflowPoiCategory, aD as TileflowPoiCategoryStyle, aE as TileflowPoiClassMapping, aF as TileflowPoiColorConfig, aG as TileflowPoiColorMode, aH as TileflowPoiDensity, aI as TileflowPoiIcons, aJ as TileflowPoiLabels, aK as TileflowProjectIconSets, aL as TileflowProjectThemes, aM as TileflowRawOverride, aN as TileflowRoadAreaStyle, aO as TileflowRoadClass, aP as TileflowRoadClassStyle, aQ as TileflowRoadColorConfig, aR as TileflowRoadDetail, aS as TileflowRoadExtras, aT as TileflowRoadHierarchy, aU as TileflowRoadLabelDetail, aV as TileflowRoadLayerStyle, aW as TileflowRoadModifier, aX as TileflowRoadOutline, aY as TileflowRoadRestriction, aZ as TileflowRoadServiceType, a_ as TileflowRoadShieldDetail, a$ as TileflowRoadShieldStyles, b0 as TileflowRoadStructure, b1 as TileflowRoadTreatmentLayerStyle, b2 as TileflowRoadTreatmentLineStyle, b3 as TileflowRoadTreatmentStyle, b4 as TileflowRoadWeight, b5 as TileflowRuntimeManifest, b6 as TileflowRuntimeManifestMap, b7 as TileflowRuntimeManifestMapEntry, b8 as TileflowRuntimeStyle, b9 as TileflowRuntimeStyleOptions, a as TileflowSessionController, ba as TileflowSessionGrantResponse, bb as TileflowStreetsBasemapConfig, bc as TileflowStreetsCompileOptions, bd as TileflowStreetsMapConfig, be as TileflowStreetsModules, bf as TileflowStreetsOptions, bg as TileflowStreetsVariant, bh as TileflowStyleOptions, bi as TileflowStyleValue, bj as TileflowSymbolPlacement, bk as TileflowSymbolPlacementStyle, bl as TileflowSymbolStyle, bm as TileflowSymbolZOrder, bn as TileflowTerrain, bo as TileflowTerrainConfig, bp as TileflowTerrainEncoding, bq as TileflowTerrainMode, br as TileflowTextAnchor, bs as TileflowTextJustify, bt as TileflowTextLayout, bu as TileflowTextPaint, bv as TileflowTextStyle, bw as TileflowTheme, bx as TileflowThemeConfig, by as TileflowThemeMode, bz as TileflowThemeModulesConfig, bA as TileflowThemeName, bB as TileflowTransitModuleConfig, bC as TileflowTransitModuleOptions, bD as TileflowTransitRailStyle, bE as TileflowTypography, bF as TileflowTypographyDomain, bG as TileflowTypographyStyle, bH as TileflowViewConfig, bI as TileflowWaterLabelClass, bJ as TileflowWaterModuleConfig, bK as TileflowWaterModuleOptions, bL as TileflowWaterwayClass, bM as TileflowWorldData, bN as TileflowZoomInterpolation, bO as TileflowZoomValue, bP as ValidationMessage, bQ as VectorTilesData, bR as addLayer, bS as aeroways, bT as boundaries, bU as buildings, bV as createManifest, bW as createStreetsStyle, bX as createStyle, bY as createStyleFromProject, bZ as createTileflowSessionController, b_ as createTileflowSessionId, b$ as defaultTileflowManifestUrl, c0 as defaultTileflowStyleBaseUrl, c1 as expression, c2 as filter, c3 as getDefaultTileflowStyleBaseUrl, c4 as getTileflowAnalyticsApiUrl, c5 as inferTileflowAnalyticsFromStyleUrl, c6 as isCanonicalOpenMapTilesSchema, c7 as isTileflowLocalDevHost, c8 as land, c9 as loadTileflowManifest, ca as mergeTileflowAnalytics, cb as moveLayer, cc as normalizeTileflowCaptureId, cd as normalizeTileflowCaptureScene, ce as normalizeTileflowStaticImageSize, cf as normalizeTileflowUrl, cg as openMapTiles, ch as openMapTilesContractVersion, ci as patchLayer, cj as removeLayer, ck as resolveTileflowAnalyticsRequestUrl, cl as resolveTileflowData, cm as resolveTileflowManifestMap, cn as resolveTileflowMapMode, co as resolveTileflowRuntimeStyle, cp as resolveTileflowStaticImageUrl, cq as resolveTileflowStyleUrl, cr as shouldLoadTileflowManifest, cs as startTileflowSession, ct as streets, cu as tileflowCaptureApplicationTargetSchema, cv as tileflowCaptureBoundsCameraSchema, cw as tileflowCaptureCameraSchema, cx as tileflowCaptureCenterCameraSchema, cy as tileflowCaptureIdSchema, cz as tileflowCaptureMapTargetSchema, cA as tileflowCaptureSceneLimits, cB as tileflowCaptureSceneNameSchema, cC as tileflowCaptureSceneSchema, cD as tileflowCaptureSceneSchemaVersion, cE as tileflowCaptureTargetSchema, cF as tileflowCaptureViewportSchema, cG as tileflowFontStack, cH as tileflowHostedNotoSansWeights, cI as tileflowPrimarySourceId, cJ as tileflowStreetsBasemapVersion, cK as tileflowStreetsPoiIconMapping, cL as tileflowWorld, cM as tileflowWorldRevision, cN as transit, cO as vectorTiles, cP as water, cQ as zoom } from './runtime-DroKDIuB.js';
+import { z } from 'zod';
+
+declare function getDefaultColors(): TileflowBaseColors;
+
+declare const tileflowThemeSchema: z.ZodObject<{
+    colors: z.ZodOptional<z.ZodObject<{
+        background: z.ZodOptional<z.ZodString>;
+        boundary: z.ZodOptional<z.ZodString>;
+        building: z.ZodOptional<z.ZodString>;
+        land: z.ZodOptional<z.ZodString>;
+        park: z.ZodOptional<z.ZodString>;
+        road: z.ZodOptional<z.ZodString>;
+        roadCasing: z.ZodOptional<z.ZodString>;
+        roadMajor: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textHalo: z.ZodOptional<z.ZodString>;
+        textMuted: z.ZodOptional<z.ZodString>;
+        water: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    extends: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
+    modules: z.ZodOptional<z.ZodObject<{
+        boundaries: z.ZodOptional<z.ZodObject<{
+            major: z.ZodOptional<z.ZodString>;
+            disputed: z.ZodOptional<z.ZodString>;
+            admin: z.ZodOptional<z.ZodString>;
+            maritime: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        buildings: z.ZodOptional<z.ZodObject<{
+            fill: z.ZodOptional<z.ZodString>;
+            outline: z.ZodOptional<z.ZodString>;
+            extrusion: z.ZodOptional<z.ZodString>;
+            highRise: z.ZodOptional<z.ZodString>;
+            highRiseOutline: z.ZodOptional<z.ZodString>;
+            lowRise: z.ZodOptional<z.ZodString>;
+            lowRiseOutline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        hydro: z.ZodOptional<z.ZodObject<{
+            water: z.ZodOptional<z.ZodString>;
+            waterway: z.ZodOptional<z.ZodString>;
+            ferry: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        labels: z.ZodOptional<z.ZodObject<{
+            water: z.ZodOptional<z.ZodString>;
+            road: z.ZodOptional<z.ZodString>;
+            poi: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+            neighborhood: z.ZodOptional<z.ZodString>;
+            halo: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodString>;
+            settlement: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        landcover: z.ZodOptional<z.ZodObject<{
+            park: z.ZodOptional<z.ZodString>;
+            grass: z.ZodOptional<z.ZodString>;
+            ice: z.ZodOptional<z.ZodString>;
+            protected: z.ZodOptional<z.ZodString>;
+            sand: z.ZodOptional<z.ZodString>;
+            wood: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        landuse: z.ZodOptional<z.ZodObject<{
+            residential: z.ZodOptional<z.ZodString>;
+            cemetery: z.ZodOptional<z.ZodString>;
+            civic: z.ZodOptional<z.ZodString>;
+            commercial: z.ZodOptional<z.ZodString>;
+            industrial: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        poi: z.ZodOptional<z.ZodObject<{
+            food: z.ZodOptional<z.ZodString>;
+            coffee: z.ZodOptional<z.ZodString>;
+            culture: z.ZodOptional<z.ZodString>;
+            transit: z.ZodOptional<z.ZodString>;
+            shopping: z.ZodOptional<z.ZodString>;
+            lodging: z.ZodOptional<z.ZodString>;
+            health: z.ZodOptional<z.ZodString>;
+            education: z.ZodOptional<z.ZodString>;
+            services: z.ZodOptional<z.ZodString>;
+            halo: z.ZodOptional<z.ZodString>;
+            icon: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        roads: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            motorway: z.ZodOptional<z.ZodString>;
+            trunk: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodString>;
+            secondary: z.ZodOptional<z.ZodString>;
+            minor: z.ZodOptional<z.ZodString>;
+            bridge: z.ZodOptional<z.ZodString>;
+            tunnel: z.ZodOptional<z.ZodString>;
+            casing: z.ZodOptional<z.ZodString>;
+            ferry: z.ZodOptional<z.ZodString>;
+            rail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    typography: z.ZodOptional<z.ZodObject<{
+        font: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodEnum<{
+            bold: "bold";
+            regular: "regular";
+            medium: "medium";
+            semibold: "semibold";
+        }>>;
+        places: z.ZodOptional<z.ZodObject<{
+            font: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodEnum<{
+                bold: "bold";
+                regular: "regular";
+                medium: "medium";
+                semibold: "semibold";
+            }>>;
+        }, z.core.$strict>>;
+        poi: z.ZodOptional<z.ZodObject<{
+            font: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodEnum<{
+                bold: "bold";
+                regular: "regular";
+                medium: "medium";
+                semibold: "semibold";
+            }>>;
+        }, z.core.$strict>>;
+        roads: z.ZodOptional<z.ZodObject<{
+            font: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodEnum<{
+                bold: "bold";
+                regular: "regular";
+                medium: "medium";
+                semibold: "semibold";
+            }>>;
+        }, z.core.$strict>>;
+        water: z.ZodOptional<z.ZodObject<{
+            font: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodEnum<{
+                bold: "bold";
+                regular: "regular";
+                medium: "medium";
+                semibold: "semibold";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const tileflowMapSchema: z.ZodType<TileflowConfig>;
+declare const configSchema: z.ZodType<TileflowConfig>;
+declare const tileflowProjectSchema: z.ZodType<TileflowProjectConfig>;
+declare function parseTileflowMap(input: unknown): TileflowConfig;
+declare function parseTileflowProject(input: unknown): TileflowProjectConfig;
+declare function validateConfig(input: unknown): ValidationResult;
+declare const validateTileflowConfig: typeof validateConfig;
+
+declare function defineTileflow<const TConfig extends TileflowProjectConfig>(config: TConfig): TConfig;
+
+declare function roads(options?: TileflowRoadsModuleOptions): TileflowRoadsModuleConfig;
+
+declare function labels(options?: TileflowLabelsModuleOptions): TileflowLabelsModuleConfig;
+
+declare function poi(options?: TileflowPoiModuleOptions): TileflowPoiModuleConfig;
+
+declare const tileflowIconPackageFileNames: readonly ["sprite.json", "sprite.png", "sprite@2x.json", "sprite@2x.png"];
+type TileflowIconPackageFileName = (typeof tileflowIconPackageFileNames)[number];
+declare const tileflowHostedIconIdPattern: RegExp;
+declare const tileflowIconPackageLimits: {
+    readonly decodeConcurrency: 4;
+    readonly maxAtlasDimension: 2048;
+    readonly maxDecodedPixelsPerIcon: 4194304;
+    readonly maxGeneratedFileBytes: number;
+    readonly maxGeneratedPackageBytes: number;
+    readonly maxIconCount: 256;
+    readonly maxSourceBytes: number;
+    readonly maxSourceFileBytes: number;
 };
-type TileflowStyleOptions = {
-    themes?: Record<string, TileflowThemeConfig>;
-    tileBaseUrl?: string;
-    tileset?: string;
+/**
+ * Portable compatibility values shared by the public CLI and hosted policy.
+ * Commercial entitlements still belong to the database package.
+ */
+declare const tileflowHostedAlphaCompatibility: {
+    readonly iconPackages: {
+        readonly maxGeneratedBytesPerProject: number;
+        readonly maxRetainedPerProject: 24;
+    };
+    readonly maxMapsPerDeploy: 1;
 };
-type TileflowManifest = {
-    version: 1;
-    tileBaseUrl: string;
-    styles: Record<string, string>;
-    maps: Record<string, string>;
+declare const tileflowIconPackageContentHashSchema: z.ZodString;
+declare const tileflowHostedIconIdSchema: z.ZodString;
+declare const tileflowRenderedIconManifestEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    pixelSha256: z.ZodObject<{
+        oneX: z.ZodString;
+        twoX: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const tileflowIconPackageLabelSchema: z.ZodString;
+declare const tileflowIconPackageManifestSchema: z.ZodObject<{
+    files: z.ZodTuple<[z.ZodObject<{
+        byteLength: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json" | "image/png">;
+        name: z.ZodLiteral<"sprite.json" | "sprite.png" | "sprite@2x.json" | "sprite@2x.png">;
+        sha256: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        byteLength: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json" | "image/png">;
+        name: z.ZodLiteral<"sprite.json" | "sprite.png" | "sprite@2x.json" | "sprite@2x.png">;
+        sha256: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        byteLength: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json" | "image/png">;
+        name: z.ZodLiteral<"sprite.json" | "sprite.png" | "sprite@2x.json" | "sprite@2x.png">;
+        sha256: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        byteLength: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json" | "image/png">;
+        name: z.ZodLiteral<"sprite.json" | "sprite.png" | "sprite@2x.json" | "sprite@2x.png">;
+        sha256: z.ZodString;
+    }, z.core.$strict>], null>;
+    format: z.ZodLiteral<"tileflow-icon-package-v1">;
+    iconNames: z.ZodArray<z.ZodString>;
+    renderedIcons: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pixelSha256: z.ZodObject<{
+            oneX: z.ZodString;
+            twoX: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    sprites: z.ZodObject<{
+        oneX: z.ZodObject<{
+            height: z.ZodNumber;
+            width: z.ZodNumber;
+            pixelRatio: z.ZodLiteral<1>;
+        }, z.core.$strict>;
+        twoX: z.ZodObject<{
+            height: z.ZodNumber;
+            width: z.ZodNumber;
+            pixelRatio: z.ZodLiteral<2>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type TileflowIconPackageManifest = z.infer<typeof tileflowIconPackageManifestSchema>;
+type TileflowRenderedIconManifestEntry = z.infer<typeof tileflowRenderedIconManifestEntrySchema>;
+declare function compareCodeUnits(left: string, right: string): number;
+declare function serializeCanonicalJson(value: unknown): string;
+declare function serializeTileflowIconPackageManifest(input: TileflowIconPackageManifest): string;
+declare function sha256Hex(input: string | Uint8Array): Promise<string>;
+declare function hashTileflowIconPackageManifest(input: TileflowIconPackageManifest): Promise<string>;
+/**
+ * Hashes the delivered pixels of one rendered icon without including its name.
+ *
+ * The v1 binary frame is the UTF-8 domain `tileflow-rendered-icon-pixels-v1\0`, followed by one
+ * byte for the pixel ratio, unsigned 32-bit big-endian width and height, then row-major RGBA.
+ * Fully transparent pixels have their RGB channels zeroed in a copy before hashing so invisible
+ * decoder data cannot create a visual difference.
+ */
+declare function hashTileflowRenderedIconPixels(input: {
+    height: number;
+    pixelRatio: 1 | 2;
+    rgba: Uint8Array;
+    width: number;
+}): Promise<string>;
+
+type TileflowIconManifestDiff = {
+    added: string[];
+    afterBytes: number;
+    beforeBytes: number;
+    modified: string[];
+    removed: string[];
+    unchangedCount: number;
 };
-type MapLibreStyle = {
-    version: 8;
-    name: string;
-    glyphs?: string;
-    sprite?: string;
-    sources: Record<string, Record<string, unknown>>;
-    layers: Array<Record<string, unknown>>;
-    terrain?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
+type TileflowIconMappingChange = {
+    after?: string;
+    before?: string;
+    key: string;
 };
-type ValidationMessage = {
-    level: 'error' | 'warning';
-    path: string;
-    message: string;
+type TileflowIconMappingDiff = {
+    added: TileflowIconMappingChange[];
+    changed: TileflowIconMappingChange[];
+    removed: TileflowIconMappingChange[];
 };
-type ValidationResult = {
-    valid: boolean;
-    messages: ValidationMessage[];
+type TileflowIconReferenceAnalysis = {
+    analysisComplete: boolean;
+    dangling: Array<{
+        iconName: string;
+        kind: 'mapping' | 'style-override-literal';
+        path: string;
+    }>;
+    unanalyzable: Array<{
+        kind: 'style-override-expression';
+        path: string;
+    }>;
 };
-declare function createStyle(input?: TileflowConfig, options?: TileflowStyleOptions): MapLibreStyle;
-declare function createStyleFromProject(projectConfig: TileflowProjectConfig, mapName: string, options?: TileflowStyleOptions): MapLibreStyle;
-declare function createManifest(projectConfig: TileflowProjectConfig, options?: {
-    styleBaseUrl?: string;
-    tileBaseUrl?: string;
-}): TileflowManifest;
-declare function getDefaultColors(): TileflowColors;
-
-declare function validateConfig(input: unknown): ValidationResult;
-
-declare function defineTileflow(config: TileflowProjectConfig): TileflowProjectConfig;
-
-declare function osm(options?: TileflowOsmBasemapOptions): TileflowOsmBasemapConfig;
-
-declare function roads(options?: TileflowRoadsModuleOptions): TileflowRoadsModuleConfig;
+declare function diffTileflowIconPackageManifests(before: TileflowIconPackageManifest | null, after: TileflowIconPackageManifest | null): TileflowIconManifestDiff;
+declare function diffTileflowIconMappings(before: Record<string, string> | null, after: Record<string, string> | null): TileflowIconMappingDiff;
+declare function inspectTileflowIconReferences(project: TileflowProjectConfig, mapName: string, availableIconNames: readonly string[]): TileflowIconReferenceAnalysis;
+declare function resolveTileflowIconMapping(project: TileflowProjectConfig, mapName: string): Record<string, string>;
 
-export { type MapLibreStyle, type TileflowBasemapConfig, type TileflowBuildings, type TileflowColorConfig, type TileflowColors, type TileflowConfig, type TileflowDensity, type TileflowFontWeight, type TileflowLabels, type TileflowManifest, type TileflowMapConfig, type TileflowModuleConfig, type TileflowOsmBasemapConfig, type TileflowOsmBasemapOptions, type TileflowPoi, type TileflowProjectConfig, type TileflowRoads, type TileflowRoadsModuleConfig, type TileflowRoadsModuleOptions, type TileflowRoadsModulePreset, type TileflowSourceLayers, type TileflowStyleOptions, type TileflowTerrain, type TileflowTerrainConfig, type TileflowTerrainEncoding, type TileflowTerrainMode, type TileflowTheme, type TileflowThemeConfig, type TileflowThemeMode, type TileflowTiles, type TileflowTilesetConfig, type TileflowTypography, type TileflowViewConfig, type ValidationMessage, type ValidationResult, createManifest, createStyle, createStyleFromProject, defineTileflow, getDefaultColors, osm, roads, validateConfig };
+export { TileflowBaseColors, TileflowConfig, type TileflowIconManifestDiff, type TileflowIconMappingChange, type TileflowIconMappingDiff, type TileflowIconPackageFileName, type TileflowIconPackageManifest, type TileflowIconReferenceAnalysis, TileflowLabelsModuleConfig, TileflowLabelsModuleOptions, TileflowPoiModuleConfig, TileflowPoiModuleOptions, TileflowProjectConfig, type TileflowRenderedIconManifestEntry, TileflowRoadsModuleConfig, TileflowRoadsModuleOptions, ValidationResult, compareCodeUnits, configSchema, defineTileflow, diffTileflowIconMappings, diffTileflowIconPackageManifests, getDefaultColors, hashTileflowIconPackageManifest, hashTileflowRenderedIconPixels, inspectTileflowIconReferences, labels, parseTileflowMap, parseTileflowProject, poi, resolveTileflowIconMapping, roads, serializeCanonicalJson, serializeTileflowIconPackageManifest, sha256Hex, tileflowHostedAlphaCompatibility, tileflowHostedIconIdPattern, tileflowHostedIconIdSchema, tileflowIconPackageContentHashSchema, tileflowIconPackageFileNames, tileflowIconPackageLabelSchema, tileflowIconPackageLimits, tileflowIconPackageManifestSchema, tileflowMapSchema, tileflowProjectSchema, tileflowRenderedIconManifestEntrySchema, tileflowThemeSchema, validateConfig, validateTileflowConfig };