@tileflow/core 0.1.0-alpha.13 → 0.1.0-alpha.14

package/README.md

@@ -128,10 +128,17 @@ labels({
 });
 ```
 
-`places`, `roads`, and `water` accept `none`, `major`, or `all`. Each value is progressive:
-`major` keeps the important labels for orientation and `all` adds local or secondary labels at
-their natural zoom. Road labels are automatically limited to road classes currently visible through
-`roads({detail})`. `language` accepts `auto`, `local`, or a language code such as `en` or `es`.
+`places` and `water` accept `none`, `major`, or `all`. Road labels follow the road hierarchy and
+accept `none`, `highways`, `major`, `streets`, or `all`: `highways` includes motorway and trunk
+labels, `major` adds primary through tertiary, `streets` adds minor streets, and `all` adds service
+roads and tracks. Path labels are eligible at `all` only when path geometry is visible; when
+`roads()` is present, enable it with `roads({extras: {paths: true}})`.
+
+Detail values select which feature classes may be labeled; they do not force every name onto the
+map. Labels keep the template's natural zoom ranges and MapLibre collision handling. Road labels
+are also clamped to the classes currently visible through `roads({detail})`, so the effective result
+is the intersection of both modules. `language` accepts `auto`, `local`, or a language code such as
+`en` or `es`.
 
 Without options, `labels()` uses `language: 'auto'` and `major` for all three label families.
 Label colors remain in `theme.modules.labels`; font family and weight remain in `typography`.

package/dist/index.d.ts

@@ -5,6 +5,7 @@ type TileflowRoads = 'hidden' | 'soft' | 'standard' | 'detailed';
 type TileflowLabels = 'none' | 'essential' | 'balanced' | 'full';
 type TileflowPoi = 'none' | 'minimal' | 'balanced' | 'full';
 type TileflowLabelDetail = 'none' | 'major' | 'all';
+type TileflowRoadLabelDetail = TileflowRoadDetail;
 type TileflowLabelLanguage = 'auto' | 'local' | 'en' | (string & {});
 type TileflowPoiCategory = 'food' | 'coffee' | 'culture' | 'transit' | 'shopping' | 'lodging' | 'health' | 'education' | 'services' | (string & {});
 type TileflowPoiIcons = boolean | 'essential' | 'full';
@@ -216,7 +217,7 @@ type TileflowLabelsModuleConfig = {
     type: 'labels';
     language?: TileflowLabelLanguage;
     places?: TileflowLabelDetail;
-    roads?: TileflowLabelDetail;
+    roads?: TileflowRoadLabelDetail;
     water?: TileflowLabelDetail;
 };
 type TileflowLabelsModuleOptions = Omit<TileflowLabelsModuleConfig, 'type'>;
@@ -764,6 +765,8 @@ declare const tileflowMapSchema: z.ZodObject<{
         roads: z.ZodOptional<z.ZodEnum<{
             none: "none";
             major: "major";
+            highways: "highways";
+            streets: "streets";
             all: "all";
         }>>;
         water: z.ZodOptional<z.ZodEnum<{
@@ -1257,6 +1260,8 @@ declare const configSchema: z.ZodObject<{
         roads: z.ZodOptional<z.ZodEnum<{
             none: "none";
             major: "major";
+            highways: "highways";
+            streets: "streets";
             all: "all";
         }>>;
         water: z.ZodOptional<z.ZodEnum<{
@@ -1963,6 +1968,8 @@ declare const tileflowProjectSchema: z.ZodObject<{
             roads: z.ZodOptional<z.ZodEnum<{
                 none: "none";
                 major: "major";
+                highways: "highways";
+                streets: "streets";
                 all: "all";
             }>>;
             water: z.ZodOptional<z.ZodEnum<{
@@ -2353,4 +2360,4 @@ declare function normalizeTileflowStaticImageSize(input: {
 };
 declare function inferTileflowAnalyticsFromStyleUrl(styleUrl: string): TileflowAnalytics | undefined;
 
-export { type MapLibreSprite, type MapLibreStyle, type TileflowAdvancedColorConfig, type TileflowAnalytics, type TileflowBaseColors, type TileflowBasemapConfig, type TileflowBoundaryColorConfig, type TileflowBuildingColorConfig, type TileflowBuildings, type TileflowColor, type TileflowColorConfig, type TileflowColors, type TileflowConfig, type TileflowDensity, type TileflowFontWeight, type TileflowFonts, type TileflowHydroColorConfig, type TileflowIconSet, type TileflowIconSetConfig, type TileflowLabelColorConfig, type TileflowLabelDetail, type TileflowLabelLanguage, type TileflowLabels, type TileflowLabelsModuleConfig, type TileflowLabelsModuleOptions, type TileflowLandcoverColorConfig, type TileflowLanduseColorConfig, type TileflowManifest, type TileflowManifestLoadOptions, type TileflowMapConfig, type TileflowMapMarker, type TileflowMapMode, type TileflowMapModeOptions, type TileflowModuleConfig, type TileflowOsmBasemapConfig, type TileflowOsmBasemapOptions, type TileflowPoi, type TileflowPoiCategory, type TileflowPoiColorConfig, type TileflowPoiIcons, type TileflowPoiLabels, type TileflowPoiModuleConfig, type TileflowPoiModuleOptions, type TileflowProjectConfig, type TileflowProjectIconSets, type TileflowProjectThemes, type TileflowRenderer, type TileflowRoadColorConfig, type TileflowRoadDetail, type TileflowRoadExtras, type TileflowRoadHierarchy, type TileflowRoadOutline, type TileflowRoadWeight, type TileflowRoads, type TileflowRoadsModuleConfig, type TileflowRoadsModuleOptions, type TileflowRuntimeManifest, type TileflowRuntimeManifestMap, type TileflowRuntimeManifestMapEntry, type TileflowRuntimeStyle, type TileflowRuntimeStyleOptions, type TileflowSourceLayers, type TileflowStyleLayerOverride, type TileflowStyleOptions, type TileflowStyleOverrideModuleConfig, type TileflowStyleOverrideOptions, type TileflowTerrain, type TileflowTerrainConfig, type TileflowTerrainEncoding, type TileflowTerrainMode, type TileflowTheme, type TileflowThemeConfig, type TileflowThemeMode, type TileflowThemeModulesConfig, type TileflowThemeName, type TileflowTiles, type TileflowTilesetConfig, type TileflowTypography, type TileflowViewConfig, type ValidationMessage, type ValidationResult, configSchema, createManifest, createStyle, createStyleFromProject, createTileflowSessionId, defaultTileflowManifestUrl, defaultTileflowStyleBaseUrl, defineTileflow, getDefaultColors, getDefaultTileflowStyleBaseUrl, getTileflowAnalyticsApiUrl, inferTileflowAnalyticsFromStyleUrl, isTileflowLocalDevHost, labels, loadTileflowManifest, mergeTileflowAnalytics, normalizeTileflowStaticImageSize, normalizeTileflowUrl, osm, parseTileflowMap, parseTileflowProject, poi, resolveTileflowAnalyticsRequestUrl, resolveTileflowManifestMap, resolveTileflowMapMode, resolveTileflowRuntimeStyle, resolveTileflowStaticImageUrl, resolveTileflowStyleUrl, roads, shouldLoadTileflowManifest, startTileflowSession, styleOverride, tileflowMapSchema, tileflowProjectSchema, tileflowThemeSchema, validateConfig, validateTileflowConfig };
+export { type MapLibreSprite, type MapLibreStyle, type TileflowAdvancedColorConfig, type TileflowAnalytics, type TileflowBaseColors, type TileflowBasemapConfig, type TileflowBoundaryColorConfig, type TileflowBuildingColorConfig, type TileflowBuildings, type TileflowColor, type TileflowColorConfig, type TileflowColors, type TileflowConfig, type TileflowDensity, type TileflowFontWeight, type TileflowFonts, type TileflowHydroColorConfig, type TileflowIconSet, type TileflowIconSetConfig, type TileflowLabelColorConfig, type TileflowLabelDetail, type TileflowLabelLanguage, type TileflowLabels, type TileflowLabelsModuleConfig, type TileflowLabelsModuleOptions, type TileflowLandcoverColorConfig, type TileflowLanduseColorConfig, type TileflowManifest, type TileflowManifestLoadOptions, type TileflowMapConfig, type TileflowMapMarker, type TileflowMapMode, type TileflowMapModeOptions, type TileflowModuleConfig, type TileflowOsmBasemapConfig, type TileflowOsmBasemapOptions, type TileflowPoi, type TileflowPoiCategory, type TileflowPoiColorConfig, type TileflowPoiIcons, type TileflowPoiLabels, type TileflowPoiModuleConfig, type TileflowPoiModuleOptions, type TileflowProjectConfig, type TileflowProjectIconSets, type TileflowProjectThemes, type TileflowRenderer, type TileflowRoadColorConfig, type TileflowRoadDetail, type TileflowRoadExtras, type TileflowRoadHierarchy, type TileflowRoadLabelDetail, type TileflowRoadOutline, type TileflowRoadWeight, type TileflowRoads, type TileflowRoadsModuleConfig, type TileflowRoadsModuleOptions, type TileflowRuntimeManifest, type TileflowRuntimeManifestMap, type TileflowRuntimeManifestMapEntry, type TileflowRuntimeStyle, type TileflowRuntimeStyleOptions, type TileflowSourceLayers, type TileflowStyleLayerOverride, type TileflowStyleOptions, type TileflowStyleOverrideModuleConfig, type TileflowStyleOverrideOptions, type TileflowTerrain, type TileflowTerrainConfig, type TileflowTerrainEncoding, type TileflowTerrainMode, type TileflowTheme, type TileflowThemeConfig, type TileflowThemeMode, type TileflowThemeModulesConfig, type TileflowThemeName, type TileflowTiles, type TileflowTilesetConfig, type TileflowTypography, type TileflowViewConfig, type ValidationMessage, type ValidationResult, configSchema, createManifest, createStyle, createStyleFromProject, createTileflowSessionId, defaultTileflowManifestUrl, defaultTileflowStyleBaseUrl, defineTileflow, getDefaultColors, getDefaultTileflowStyleBaseUrl, getTileflowAnalyticsApiUrl, inferTileflowAnalyticsFromStyleUrl, isTileflowLocalDevHost, labels, loadTileflowManifest, mergeTileflowAnalytics, normalizeTileflowStaticImageSize, normalizeTileflowUrl, osm, parseTileflowMap, parseTileflowProject, poi, resolveTileflowAnalyticsRequestUrl, resolveTileflowManifestMap, resolveTileflowMapMode, resolveTileflowRuntimeStyle, resolveTileflowStaticImageUrl, resolveTileflowStyleUrl, roads, shouldLoadTileflowManifest, startTileflowSession, styleOverride, tileflowMapSchema, tileflowProjectSchema, tileflowThemeSchema, validateConfig, validateTileflowConfig };