osmgl 0.1.0 → 0.3.0

package/dist/osmgl.d.cts

@@ -688,6 +688,24 @@ declare class Shader {
  * Стиль хранится в `styles/*.json` и целиком вшивается в бандл — карта должна
  * рисоваться без единого сетевого запроса за конфигом.
  */
+/**
+ * Цвет, ВЫВЕДЕННЫЙ ИЗ ЦВЕТА ДРУГОГО СЛОЯ: «как у него, только темнее».
+ *
+ * Нужен обводке моста. Собственный цвет ей задать нельзя: тем два десятка, каждая красит дороги
+ * по-своему, и любой фиксированный хекс на половине из них смотрелся бы чужим. Полупрозрачная
+ * затемняющая краска эту задачу решала, но полупрозрачной линии нельзя: капсулы соседних отрезков
+ * перекрываются на изломах, и краска ложится дважды — по вершинам идёт цепочка тёмных бусин.
+ * (Трафарет «красить пиксель один раз» бусины убирает, но взамен оставляет светлый шов по
+ * сглаженному краю первой капсулы — проверено.)
+ *
+ * Ссылка снимает вопрос: тема красит обводку дороги, а обводка моста едет следом сама.
+ */
+interface ColorFrom {
+    /** Идентификатор слоя, у которого берём цвет. */
+    from: string;
+    /** Насколько затемнить, 0..1 (0.25 — четверть). */
+    darken?: number;
+}
 /** Значение, зависящее от зума: число/цвет либо остановки для интерполяции. */
 type Interpolated<T> = T | {
     stops: [number, T][];
@@ -827,13 +845,41 @@ interface FillLayerSpec extends LayerBase {
 }
 interface LineLayerSpec extends LayerBase {
     type: 'line';
+    /**
+     * СЕТЬ, внутри которой порядок отрисовки решают не слои, а уровни пересечения.
+     *
+     * Все дорожные слои стиля — обводки, полотна, тень моста — помечаются одним именем (`roads`), и
+     * рисуются они не подряд, а по уровням: сначала вся сеть уровня −1 (тоннели), потом вся сеть
+     * земли, потом вся сеть эстакад. Поэтому мост со своей тенью и обводкой ложится ЦЕЛИКОМ поверх
+     * улицы под ним, какого бы класса та ни была, — а не «полотно моста поверх, обводка под».
+     *
+     * Так же устроено у Яндекса: у каждого дорожного слоя `line-network: "roads"` и
+     * `line-z-level: ["get","z_level"]`. Уровень фичи считается по `generators/level`.
+     *
+     * Сеть рисуется целиком НА МЕСТЕ ПЕРВОГО своего слоя в стиле; порядок внутри уровня — обычный,
+     * по порядку слоёв.
+     */
+    network?: string;
     paint: MaterialPaint & {
-        color: Interpolated<string>;
+        /** Цвет линии; `{ from, darken }` — «как у такого-то слоя, только темнее» (см. `ColorFrom`). */
+        color: Interpolated<string> | ColorFrom;
         /** Ширина в ЭКРАННЫХ пикселях: линия не толстеет с приближением к камере. */
         width: Interpolated<number>;
         opacity?: Interpolated<number>;
         /** Сдвиг поперёк линии в пикселях — для обочин и параллельных путей. */
         offset?: Interpolated<number>;
+        /**
+         * РАЗМЫТИЕ КРАЯ в пикселях: край растягивается на столько вместо обычного полупикселя.
+         *
+         * Нужно тени моста. У Яндекса тени нет вовсе как отдельной сущности — там на каждый мост
+         * рисуется ВОСЕМЬ вложенных контуров (`road-sd-shadow-1…8__bridge`), каждый с прозрачностью
+         * 0.03–0.08, и их сумма изображает размытие. Это обход отсутствующего в их движке размытия:
+         * восемь слоёв в стиле и восемь вызовов отрисовки на тайл ради градиента.
+         *
+         * У нас край линии и так вырезает фрагментный шейдер по расстоянию до оси — растянуть переход
+         * стоит одного юниформа. Поэтому тень моста здесь ОДИН слой с честным мягким краем.
+         */
+        blur?: Interpolated<number>;
         /**
          * Уровень полотна в МЕТРАХ — для рельефных вариантов карты: дорожка внутри
          * приподнятого парка должна лежать на нём, а не тонуть под ним. Меняется
@@ -1140,6 +1186,14 @@ interface SurfaceLayerSpec extends LayerBase {
     /** Ширина фаски по горизонтали, метры. 0 — резкий край. */
     bevel?: number;
     /** На сколько фаска опускается, метры. */
+    /**
+     * Насколько широкую щель между кусками СЛИТЬ, метры. По умолчанию — общее значение движка.
+     *
+     * Ноль нужен слоям, куски которых обязаны остаться порознь. Первый такой — зебра перехода: она
+     * набрана отдельными полосами с промежутками около метра, и общая сварка слепила её в сплошную
+     * белую плиту.
+     */
+    weld?: number;
     bevelDrop?: number;
     paint: MaterialPaint & {
         color: Interpolated<string>;
@@ -1341,6 +1395,13 @@ interface LayerPlan {
     maxzoom: number;
     /** Разбить слой на меши по значению свойства (этажи — см. `LayerBase.splitBy`). */
     splitBy?: string;
+    /**
+     * Слой входит в СЕТЬ (`LineLayerSpec.network`): меш бьётся по уровням пересечения.
+     *
+     * Воркеру важно не имя сети, а сам факт: по уровню он раскладывает геометрию, а порядок
+     * расставляет уже рендер.
+     */
+    network?: string;
     /** Скругление углов в метрах — геометрия, поэтому едет в воркер. */
     cornerRadius?: number;
     cornerSegments?: number;
@@ -1350,6 +1411,7 @@ interface LayerPlan {
     elevation?: number;
     base?: number;
     bevel?: number;
+    weld?: number;
     bevelDrop?: number;
     /**
      * Линия ложится НА ПОВЕРХНОСТЬ, по которой идёт (см. `generators/ground`).
@@ -1607,6 +1669,14 @@ interface LoadedResponse {
      * этажи вообще есть в этом здании.
      */
     splits?: Record<string, (string | number)[]>;
+    /**
+     * Уровни пересечения, встретившиеся в этом тайле (см. `generators/level`), по возрастанию.
+     *
+     * Дорожная сеть рисуется НЕ по слоям, а по уровням: сначала всё, что под землёй, потом земля,
+     * потом эстакады. Какие уровни в тайле есть, знает только тот, кто его разобрал, — рендеру
+     * перебирать все возможные значения было бы дороже, чем передать список.
+     */
+    levels?: number[];
     timing: {
         fetchMs: number;
         parseMs: number;
@@ -3706,6 +3776,18 @@ declare class LayerRenderer {
     private applyMaterial;
     private drawFill;
     private drawLine;
+    /**
+     * СЕТЬ ЦЕЛИКОМ, по уровням пересечения (см. `LineLayerSpec.network`).
+     *
+     * Обычный слой рисуется на своём месте в стиле. Сеть так рисовать нельзя: обводка эстакады
+     * должна лежать поверх ПОЛОТНА улицы под ней, а полотно улицы в стиле идёт позже обводок.
+     * Поэтому вся сеть рисуется одним куском на месте своего первого слоя, и снаружи внутрь порядок
+     * такой: уровень (тоннели → земля → эстакады), а внутри уровня — обычный порядок слоёв.
+     *
+     * Какие уровни в кадре есть, считаем по видимым тайлам: в обычном городе это один нулевой, и
+     * тогда всё сводится к прежней отрисовке слой за слоем.
+     */
+    private drawNetwork;
     /**
      * Подсветка выбранного здания.
      *
@@ -4351,6 +4433,19 @@ interface RoundOptions {
      * получилась бы ступенька.
      */
     extent?: number;
+    /**
+     * Насколько дальше квадрата тайла проходит НАСТОЯЩИЙ разрез, единицы тайла.
+     *
+     * Замораживать надо ровно линию разреза, а не квадрат. Пока поверхности резались по квадрату,
+     * это было одно и то же, но теперь они режутся с запасом (`cutMargin`), и геометрия законно живёт
+     * за квадратом. Со старым определением одна и та же вершина у левого тайла оказывалась «за
+     * границей» и не скруглялась, а у правого — внутри и срезалась: контуры расходились, и вдоль
+     * стыка появлялся вырезанный уступ. Замечено на клине газона в центре Душанбе — обе соседние
+     * зелёные области были срезаны по одной вертикали, ровно по границе тайла.
+     *
+     * Ноль — прежнее поведение: разрез идёт по квадрату (так режут здания и заливки).
+     */
+    margin?: number;
     /**
      * Вершины, которые скруглять НЕЛЬЗЯ (по индексу в кольце без замыкающей
      * точки). Ими помечают углы на общем ребре с соседним полигоном: скругление
@@ -4700,9 +4795,47 @@ interface LineMesh {
     vertexCount: number;
     indexCount: number;
 }
+interface LineOptions {
+    /**
+     * Уровень пересечения (см. `generators/level`): берём только фичи этого уровня.
+     *
+     * `undefined` — уровни не разделяем, слой строится целиком (так живут все слои, кроме дорожной
+     * сети: у реки или границы пересечений без связи не бывает).
+     */
+    level?: number;
+}
 declare function generateLine(layer: VectorTileLayer, filter: Filter | undefined, maxSegment?: number, 
 /** Уровни поверхностей тайла: по ним дорога ложится на то, по чему идёт. Нет — лежит на нуле. */
-ground?: GroundField): LineMesh | null;
+ground?: GroundField, 
+/** Метров в единице тайла. Ноль — плавный переход ширины на стыках не строится. */
+metersPerUnit?: number, opts?: LineOptions): LineMesh | null;
+
+/**
+ * УРОВЕНЬ ПЕРЕСЕЧЕНИЯ — какой из двух дорог быть сверху там, где они пересекаются без связи.
+ *
+ * ЗАЧЕМ. Плоская карта рисуется краской: слои идут в порядке стиля, и внутри слоя порядок фич
+ * произволен. Поэтому эстакада над улицей ничем не отличалась от перекрёстка — обводки сливались,
+ * полотна пересекались, и место читалось как съезд, которого в жизни нет. Ровно этим у Яндекса
+ * занят `line-z-level` (`["get","z_level"]` у КАЖДОГО дорожного слоя, все они в одной сети
+ * `line-network: "roads"`): сеть рисуется не по слоям, а по уровням, и мост со своей тенью и
+ * обводкой целиком ложится поверх того, что под ним.
+ *
+ * ОТКУДА ЧИСЛО. Готового `z_level` в наших тайлах нет, зато есть то, из чего его считают:
+ *   `layer`   — тег OSM, честный уровень (−1 подземный, 1 над землёй, изредка 2…5);
+ *   `brunnel` — «мост / тоннель / брод», он приходит и там, где `layer` не проставлен.
+ * Поэтому берём `layer`, а если его нет — выводим уровень из `brunnel`. Мост без `layer`
+ * (в Душанбе таких большинство) получает 1, тоннель — −1, обычная улица — 0.
+ *
+ * Считается в ВОРКЕРЕ, при тесселяции: по уровню бьётся меш, и рендеру остаётся только порядок.
+ */
+/**
+ * Дальше этого уровни не разводим. В OSM попадается и `layer=5`, и опечатки в сотни: каждое
+ * значение — это отдельный бакет и отдельный вызов отрисовки, поэтому хвост подрезаем. Пять этажей
+ * развязки — больше, чем бывает на настоящих.
+ */
+declare const LEVEL_LIMIT = 5;
+/** Уровень фичи: `layer` из тегов, иначе вывод из `brunnel`. */
+declare function featureLevel(props: Record<string, unknown>): number;
 
 /**
  * Положение камеры в адресе страницы.
@@ -4802,6 +4935,8 @@ interface SurfaceOptions {
     /** Ширина фаски по горизонтали, метры. 0 — резкий край. */
     bevel?: number;
     /** Насколько фаска опускается по высоте, метры. */
+    /** Насколько широкую щель между кусками слить, метры. Пусто — SURFACE_WELD_METERS. */
+    weld?: number;
     bevelDrop?: number;
     /** Скругление углов в плане, метры. */
     cornerRadius?: number;
@@ -5656,4 +5791,4 @@ declare class Map$1 extends Evented<MapEvents> {
     destroy(): void;
 }
 
-export { type AnimationOptions, AssetLoader, type AssetLoaderOptions, BASE_SOURCE, BUILDING_HEIGHT_SCALE, BUILDING_VERTEX_STRIDE, type BuildingHit, type BuildingsMesh, CITY_STYLE, type CameraOptions, Circle, type CircleOptions, type CoverOptions, DEFAULT_ICONS, DEFAULT_LIGHT, DEFAULT_SHADOWS, DEFAULT_SKY, DEFAULT_STYLE, DepthTarget, type DeviceHints, EARTH_CIRCUMFERENCE, FILL_VERTEX_STRIDE, type Filter, type FitBoundsOptions, type FitViewport, type FogPlanes, GLOBE_MAX_PITCH, GLOBE_ZOOM_MAX, GLOBE_ZOOM_MIN, GLYPH_BORDER, GLYPH_SIZE, GROUND_SCALE, GeomType, type GestureOptions, type Glyph, type GlyphMetric, GlyphSource, GroundArrows, IconSource, IndoorMask, type Interpolated, LINE_VERTEX_STRIDE, type LayerPlan, LayerRenderer, type LightSpec, type LinePlacement, type LngLat, LngLatBounds, type LngLatLike, MAX_LATITUDE, MODEL_VERTEX_STRIDE, Map$1 as Map, type MapEvents, MapObject, type MapObjectOptions, type MapOptions, Marker, type MarkerOptions, Model, ModelLayer, type ModelMesh, type ModelOptions, type ModelPrimitive, ObjectManager, type ObjectPaint, type ObjectPart, type Padding, type PlacedGlyph, type PlacedSymbol, Polygon, type PolygonOptions, Polyline, type PolylineOptions, type PolylineSegment, Popup, type PopupOptions, type Projection, type QualityName, type QualityProfile, RELIEF_STYLE, RUNTIME_FILL_STRIDE, RUNTIME_LINE_STRIDE, RasterSource, type RasterSourceOptions, RasterTile, type RoundOptions, type RuntimeMesh, SDF_EDGE, SDF_PX, SOFT_STYLE, SPLIT_SEP, SURFACE_CUT_BLEED, SURFACE_LEVEL_SCALE, SURFACE_VERTEX_STRIDE, type ScreenPoint$1 as ScreenPoint, SdfAtlas, type ShadowSettings, type SkySpec, Style, type StyleLayerSpec, type StyleSpec, type SymbolHit, SymbolRenderer, THEMES, TILE_SIZE, type ThemeSpec, TileID, Transform, VectorTile, VectorTileFeature, VectorTileLayer, abbreviateStreet, addGround, altitudeFromMercatorZ, applyTheme, arrowLabelOffset, arrowVertices, buildRuntimeFill, buildRuntimeLine, cameraForBounds, circumferenceAtLatitude, clampLat, clampPixelRatio, clipLineToRect, coordinateDigits, coveringTiles, createGround, Map$1 as default, deviceHints, distToSegment, evaluateColor, evaluateNumber, extractFeature, fillFootprint, fogPlanes, footprintOf, formatHash, generateBuildings, generateFill, generateLine, generateSurface, generateSymbols, globeBasis, globeFlatMix, globeRadius, globeToLocal, groundAt, iconRotation, insideFootprint, latFromMercatorY, lngFromMercatorX, lngLatToUnit, matchesFilter, mercatorMetersPerTile, mercatorX, mercatorY, mercatorZFromAltitude, metersPerPixel, metersPerTile, nextQualityDown, parseGlb, parseGlbAsync, parseGlyphs, parseHash, patchUV, pickBuilding, pickFill, pitchIntent, pixelsPerMeter, placeAlongLine, pointInRing, qualityFor, qualityProfile, raySphere, resolveTemplate, roundRing, sdfFromAlpha, shapeText, splitBucketKey, splitByGround, splitPolygons, styleWithTheme, tileOriginMeters, tileUrl, toLngLat, unitToLngLat, worldSize };
+export { type AnimationOptions, AssetLoader, type AssetLoaderOptions, BASE_SOURCE, BUILDING_HEIGHT_SCALE, BUILDING_VERTEX_STRIDE, type BuildingHit, type BuildingsMesh, CITY_STYLE, type CameraOptions, Circle, type CircleOptions, type CoverOptions, DEFAULT_ICONS, DEFAULT_LIGHT, DEFAULT_SHADOWS, DEFAULT_SKY, DEFAULT_STYLE, DepthTarget, type DeviceHints, EARTH_CIRCUMFERENCE, FILL_VERTEX_STRIDE, type Filter, type FitBoundsOptions, type FitViewport, type FogPlanes, GLOBE_MAX_PITCH, GLOBE_ZOOM_MAX, GLOBE_ZOOM_MIN, GLYPH_BORDER, GLYPH_SIZE, GROUND_SCALE, GeomType, type GestureOptions, type Glyph, type GlyphMetric, GlyphSource, GroundArrows, IconSource, IndoorMask, type Interpolated, LEVEL_LIMIT, LINE_VERTEX_STRIDE, type LayerPlan, LayerRenderer, type LightSpec, type LinePlacement, type LngLat, LngLatBounds, type LngLatLike, MAX_LATITUDE, MODEL_VERTEX_STRIDE, Map$1 as Map, type MapEvents, MapObject, type MapObjectOptions, type MapOptions, Marker, type MarkerOptions, Model, ModelLayer, type ModelMesh, type ModelOptions, type ModelPrimitive, ObjectManager, type ObjectPaint, type ObjectPart, type Padding, type PlacedGlyph, type PlacedSymbol, Polygon, type PolygonOptions, Polyline, type PolylineOptions, type PolylineSegment, Popup, type PopupOptions, type Projection, type QualityName, type QualityProfile, RELIEF_STYLE, RUNTIME_FILL_STRIDE, RUNTIME_LINE_STRIDE, RasterSource, type RasterSourceOptions, RasterTile, type RoundOptions, type RuntimeMesh, SDF_EDGE, SDF_PX, SOFT_STYLE, SPLIT_SEP, SURFACE_CUT_BLEED, SURFACE_LEVEL_SCALE, SURFACE_VERTEX_STRIDE, type ScreenPoint$1 as ScreenPoint, SdfAtlas, type ShadowSettings, type SkySpec, Style, type StyleLayerSpec, type StyleSpec, type SymbolHit, SymbolRenderer, THEMES, TILE_SIZE, type ThemeSpec, TileID, Transform, VectorTile, VectorTileFeature, VectorTileLayer, abbreviateStreet, addGround, altitudeFromMercatorZ, applyTheme, arrowLabelOffset, arrowVertices, buildRuntimeFill, buildRuntimeLine, cameraForBounds, circumferenceAtLatitude, clampLat, clampPixelRatio, clipLineToRect, coordinateDigits, coveringTiles, createGround, Map$1 as default, deviceHints, distToSegment, evaluateColor, evaluateNumber, extractFeature, featureLevel, fillFootprint, fogPlanes, footprintOf, formatHash, generateBuildings, generateFill, generateLine, generateSurface, generateSymbols, globeBasis, globeFlatMix, globeRadius, globeToLocal, groundAt, iconRotation, insideFootprint, latFromMercatorY, lngFromMercatorX, lngLatToUnit, matchesFilter, mercatorMetersPerTile, mercatorX, mercatorY, mercatorZFromAltitude, metersPerPixel, metersPerTile, nextQualityDown, parseGlb, parseGlbAsync, parseGlyphs, parseHash, patchUV, pickBuilding, pickFill, pitchIntent, pixelsPerMeter, placeAlongLine, pointInRing, qualityFor, qualityProfile, raySphere, resolveTemplate, roundRing, sdfFromAlpha, shapeText, splitBucketKey, splitByGround, splitPolygons, styleWithTheme, tileOriginMeters, tileUrl, toLngLat, unitToLngLat, worldSize };

package/dist/osmgl.d.ts

@@ -688,6 +688,24 @@ declare class Shader {
  * Стиль хранится в `styles/*.json` и целиком вшивается в бандл — карта должна
  * рисоваться без единого сетевого запроса за конфигом.
  */
+/**
+ * Цвет, ВЫВЕДЕННЫЙ ИЗ ЦВЕТА ДРУГОГО СЛОЯ: «как у него, только темнее».
+ *
+ * Нужен обводке моста. Собственный цвет ей задать нельзя: тем два десятка, каждая красит дороги
+ * по-своему, и любой фиксированный хекс на половине из них смотрелся бы чужим. Полупрозрачная
+ * затемняющая краска эту задачу решала, но полупрозрачной линии нельзя: капсулы соседних отрезков
+ * перекрываются на изломах, и краска ложится дважды — по вершинам идёт цепочка тёмных бусин.
+ * (Трафарет «красить пиксель один раз» бусины убирает, но взамен оставляет светлый шов по
+ * сглаженному краю первой капсулы — проверено.)
+ *
+ * Ссылка снимает вопрос: тема красит обводку дороги, а обводка моста едет следом сама.
+ */
+interface ColorFrom {
+    /** Идентификатор слоя, у которого берём цвет. */
+    from: string;
+    /** Насколько затемнить, 0..1 (0.25 — четверть). */
+    darken?: number;
+}
 /** Значение, зависящее от зума: число/цвет либо остановки для интерполяции. */
 type Interpolated<T> = T | {
     stops: [number, T][];
@@ -827,13 +845,41 @@ interface FillLayerSpec extends LayerBase {
 }
 interface LineLayerSpec extends LayerBase {
     type: 'line';
+    /**
+     * СЕТЬ, внутри которой порядок отрисовки решают не слои, а уровни пересечения.
+     *
+     * Все дорожные слои стиля — обводки, полотна, тень моста — помечаются одним именем (`roads`), и
+     * рисуются они не подряд, а по уровням: сначала вся сеть уровня −1 (тоннели), потом вся сеть
+     * земли, потом вся сеть эстакад. Поэтому мост со своей тенью и обводкой ложится ЦЕЛИКОМ поверх
+     * улицы под ним, какого бы класса та ни была, — а не «полотно моста поверх, обводка под».
+     *
+     * Так же устроено у Яндекса: у каждого дорожного слоя `line-network: "roads"` и
+     * `line-z-level: ["get","z_level"]`. Уровень фичи считается по `generators/level`.
+     *
+     * Сеть рисуется целиком НА МЕСТЕ ПЕРВОГО своего слоя в стиле; порядок внутри уровня — обычный,
+     * по порядку слоёв.
+     */
+    network?: string;
     paint: MaterialPaint & {
-        color: Interpolated<string>;
+        /** Цвет линии; `{ from, darken }` — «как у такого-то слоя, только темнее» (см. `ColorFrom`). */
+        color: Interpolated<string> | ColorFrom;
         /** Ширина в ЭКРАННЫХ пикселях: линия не толстеет с приближением к камере. */
         width: Interpolated<number>;
         opacity?: Interpolated<number>;
         /** Сдвиг поперёк линии в пикселях — для обочин и параллельных путей. */
         offset?: Interpolated<number>;
+        /**
+         * РАЗМЫТИЕ КРАЯ в пикселях: край растягивается на столько вместо обычного полупикселя.
+         *
+         * Нужно тени моста. У Яндекса тени нет вовсе как отдельной сущности — там на каждый мост
+         * рисуется ВОСЕМЬ вложенных контуров (`road-sd-shadow-1…8__bridge`), каждый с прозрачностью
+         * 0.03–0.08, и их сумма изображает размытие. Это обход отсутствующего в их движке размытия:
+         * восемь слоёв в стиле и восемь вызовов отрисовки на тайл ради градиента.
+         *
+         * У нас край линии и так вырезает фрагментный шейдер по расстоянию до оси — растянуть переход
+         * стоит одного юниформа. Поэтому тень моста здесь ОДИН слой с честным мягким краем.
+         */
+        blur?: Interpolated<number>;
         /**
          * Уровень полотна в МЕТРАХ — для рельефных вариантов карты: дорожка внутри
          * приподнятого парка должна лежать на нём, а не тонуть под ним. Меняется
@@ -1140,6 +1186,14 @@ interface SurfaceLayerSpec extends LayerBase {
     /** Ширина фаски по горизонтали, метры. 0 — резкий край. */
     bevel?: number;
     /** На сколько фаска опускается, метры. */
+    /**
+     * Насколько широкую щель между кусками СЛИТЬ, метры. По умолчанию — общее значение движка.
+     *
+     * Ноль нужен слоям, куски которых обязаны остаться порознь. Первый такой — зебра перехода: она
+     * набрана отдельными полосами с промежутками около метра, и общая сварка слепила её в сплошную
+     * белую плиту.
+     */
+    weld?: number;
     bevelDrop?: number;
     paint: MaterialPaint & {
         color: Interpolated<string>;
@@ -1341,6 +1395,13 @@ interface LayerPlan {
     maxzoom: number;
     /** Разбить слой на меши по значению свойства (этажи — см. `LayerBase.splitBy`). */
     splitBy?: string;
+    /**
+     * Слой входит в СЕТЬ (`LineLayerSpec.network`): меш бьётся по уровням пересечения.
+     *
+     * Воркеру важно не имя сети, а сам факт: по уровню он раскладывает геометрию, а порядок
+     * расставляет уже рендер.
+     */
+    network?: string;
     /** Скругление углов в метрах — геометрия, поэтому едет в воркер. */
     cornerRadius?: number;
     cornerSegments?: number;
@@ -1350,6 +1411,7 @@ interface LayerPlan {
     elevation?: number;
     base?: number;
     bevel?: number;
+    weld?: number;
     bevelDrop?: number;
     /**
      * Линия ложится НА ПОВЕРХНОСТЬ, по которой идёт (см. `generators/ground`).
@@ -1607,6 +1669,14 @@ interface LoadedResponse {
      * этажи вообще есть в этом здании.
      */
     splits?: Record<string, (string | number)[]>;
+    /**
+     * Уровни пересечения, встретившиеся в этом тайле (см. `generators/level`), по возрастанию.
+     *
+     * Дорожная сеть рисуется НЕ по слоям, а по уровням: сначала всё, что под землёй, потом земля,
+     * потом эстакады. Какие уровни в тайле есть, знает только тот, кто его разобрал, — рендеру
+     * перебирать все возможные значения было бы дороже, чем передать список.
+     */
+    levels?: number[];
     timing: {
         fetchMs: number;
         parseMs: number;
@@ -3706,6 +3776,18 @@ declare class LayerRenderer {
     private applyMaterial;
     private drawFill;
     private drawLine;
+    /**
+     * СЕТЬ ЦЕЛИКОМ, по уровням пересечения (см. `LineLayerSpec.network`).
+     *
+     * Обычный слой рисуется на своём месте в стиле. Сеть так рисовать нельзя: обводка эстакады
+     * должна лежать поверх ПОЛОТНА улицы под ней, а полотно улицы в стиле идёт позже обводок.
+     * Поэтому вся сеть рисуется одним куском на месте своего первого слоя, и снаружи внутрь порядок
+     * такой: уровень (тоннели → земля → эстакады), а внутри уровня — обычный порядок слоёв.
+     *
+     * Какие уровни в кадре есть, считаем по видимым тайлам: в обычном городе это один нулевой, и
+     * тогда всё сводится к прежней отрисовке слой за слоем.
+     */
+    private drawNetwork;
     /**
      * Подсветка выбранного здания.
      *
@@ -4351,6 +4433,19 @@ interface RoundOptions {
      * получилась бы ступенька.
      */
     extent?: number;
+    /**
+     * Насколько дальше квадрата тайла проходит НАСТОЯЩИЙ разрез, единицы тайла.
+     *
+     * Замораживать надо ровно линию разреза, а не квадрат. Пока поверхности резались по квадрату,
+     * это было одно и то же, но теперь они режутся с запасом (`cutMargin`), и геометрия законно живёт
+     * за квадратом. Со старым определением одна и та же вершина у левого тайла оказывалась «за
+     * границей» и не скруглялась, а у правого — внутри и срезалась: контуры расходились, и вдоль
+     * стыка появлялся вырезанный уступ. Замечено на клине газона в центре Душанбе — обе соседние
+     * зелёные области были срезаны по одной вертикали, ровно по границе тайла.
+     *
+     * Ноль — прежнее поведение: разрез идёт по квадрату (так режут здания и заливки).
+     */
+    margin?: number;
     /**
      * Вершины, которые скруглять НЕЛЬЗЯ (по индексу в кольце без замыкающей
      * точки). Ими помечают углы на общем ребре с соседним полигоном: скругление
@@ -4700,9 +4795,47 @@ interface LineMesh {
     vertexCount: number;
     indexCount: number;
 }
+interface LineOptions {
+    /**
+     * Уровень пересечения (см. `generators/level`): берём только фичи этого уровня.
+     *
+     * `undefined` — уровни не разделяем, слой строится целиком (так живут все слои, кроме дорожной
+     * сети: у реки или границы пересечений без связи не бывает).
+     */
+    level?: number;
+}
 declare function generateLine(layer: VectorTileLayer, filter: Filter | undefined, maxSegment?: number, 
 /** Уровни поверхностей тайла: по ним дорога ложится на то, по чему идёт. Нет — лежит на нуле. */
-ground?: GroundField): LineMesh | null;
+ground?: GroundField, 
+/** Метров в единице тайла. Ноль — плавный переход ширины на стыках не строится. */
+metersPerUnit?: number, opts?: LineOptions): LineMesh | null;
+
+/**
+ * УРОВЕНЬ ПЕРЕСЕЧЕНИЯ — какой из двух дорог быть сверху там, где они пересекаются без связи.
+ *
+ * ЗАЧЕМ. Плоская карта рисуется краской: слои идут в порядке стиля, и внутри слоя порядок фич
+ * произволен. Поэтому эстакада над улицей ничем не отличалась от перекрёстка — обводки сливались,
+ * полотна пересекались, и место читалось как съезд, которого в жизни нет. Ровно этим у Яндекса
+ * занят `line-z-level` (`["get","z_level"]` у КАЖДОГО дорожного слоя, все они в одной сети
+ * `line-network: "roads"`): сеть рисуется не по слоям, а по уровням, и мост со своей тенью и
+ * обводкой целиком ложится поверх того, что под ним.
+ *
+ * ОТКУДА ЧИСЛО. Готового `z_level` в наших тайлах нет, зато есть то, из чего его считают:
+ *   `layer`   — тег OSM, честный уровень (−1 подземный, 1 над землёй, изредка 2…5);
+ *   `brunnel` — «мост / тоннель / брод», он приходит и там, где `layer` не проставлен.
+ * Поэтому берём `layer`, а если его нет — выводим уровень из `brunnel`. Мост без `layer`
+ * (в Душанбе таких большинство) получает 1, тоннель — −1, обычная улица — 0.
+ *
+ * Считается в ВОРКЕРЕ, при тесселяции: по уровню бьётся меш, и рендеру остаётся только порядок.
+ */
+/**
+ * Дальше этого уровни не разводим. В OSM попадается и `layer=5`, и опечатки в сотни: каждое
+ * значение — это отдельный бакет и отдельный вызов отрисовки, поэтому хвост подрезаем. Пять этажей
+ * развязки — больше, чем бывает на настоящих.
+ */
+declare const LEVEL_LIMIT = 5;
+/** Уровень фичи: `layer` из тегов, иначе вывод из `brunnel`. */
+declare function featureLevel(props: Record<string, unknown>): number;
 
 /**
  * Положение камеры в адресе страницы.
@@ -4802,6 +4935,8 @@ interface SurfaceOptions {
     /** Ширина фаски по горизонтали, метры. 0 — резкий край. */
     bevel?: number;
     /** Насколько фаска опускается по высоте, метры. */
+    /** Насколько широкую щель между кусками слить, метры. Пусто — SURFACE_WELD_METERS. */
+    weld?: number;
     bevelDrop?: number;
     /** Скругление углов в плане, метры. */
     cornerRadius?: number;
@@ -5656,4 +5791,4 @@ declare class Map$1 extends Evented<MapEvents> {
     destroy(): void;
 }
 
-export { type AnimationOptions, AssetLoader, type AssetLoaderOptions, BASE_SOURCE, BUILDING_HEIGHT_SCALE, BUILDING_VERTEX_STRIDE, type BuildingHit, type BuildingsMesh, CITY_STYLE, type CameraOptions, Circle, type CircleOptions, type CoverOptions, DEFAULT_ICONS, DEFAULT_LIGHT, DEFAULT_SHADOWS, DEFAULT_SKY, DEFAULT_STYLE, DepthTarget, type DeviceHints, EARTH_CIRCUMFERENCE, FILL_VERTEX_STRIDE, type Filter, type FitBoundsOptions, type FitViewport, type FogPlanes, GLOBE_MAX_PITCH, GLOBE_ZOOM_MAX, GLOBE_ZOOM_MIN, GLYPH_BORDER, GLYPH_SIZE, GROUND_SCALE, GeomType, type GestureOptions, type Glyph, type GlyphMetric, GlyphSource, GroundArrows, IconSource, IndoorMask, type Interpolated, LINE_VERTEX_STRIDE, type LayerPlan, LayerRenderer, type LightSpec, type LinePlacement, type LngLat, LngLatBounds, type LngLatLike, MAX_LATITUDE, MODEL_VERTEX_STRIDE, Map$1 as Map, type MapEvents, MapObject, type MapObjectOptions, type MapOptions, Marker, type MarkerOptions, Model, ModelLayer, type ModelMesh, type ModelOptions, type ModelPrimitive, ObjectManager, type ObjectPaint, type ObjectPart, type Padding, type PlacedGlyph, type PlacedSymbol, Polygon, type PolygonOptions, Polyline, type PolylineOptions, type PolylineSegment, Popup, type PopupOptions, type Projection, type QualityName, type QualityProfile, RELIEF_STYLE, RUNTIME_FILL_STRIDE, RUNTIME_LINE_STRIDE, RasterSource, type RasterSourceOptions, RasterTile, type RoundOptions, type RuntimeMesh, SDF_EDGE, SDF_PX, SOFT_STYLE, SPLIT_SEP, SURFACE_CUT_BLEED, SURFACE_LEVEL_SCALE, SURFACE_VERTEX_STRIDE, type ScreenPoint$1 as ScreenPoint, SdfAtlas, type ShadowSettings, type SkySpec, Style, type StyleLayerSpec, type StyleSpec, type SymbolHit, SymbolRenderer, THEMES, TILE_SIZE, type ThemeSpec, TileID, Transform, VectorTile, VectorTileFeature, VectorTileLayer, abbreviateStreet, addGround, altitudeFromMercatorZ, applyTheme, arrowLabelOffset, arrowVertices, buildRuntimeFill, buildRuntimeLine, cameraForBounds, circumferenceAtLatitude, clampLat, clampPixelRatio, clipLineToRect, coordinateDigits, coveringTiles, createGround, Map$1 as default, deviceHints, distToSegment, evaluateColor, evaluateNumber, extractFeature, fillFootprint, fogPlanes, footprintOf, formatHash, generateBuildings, generateFill, generateLine, generateSurface, generateSymbols, globeBasis, globeFlatMix, globeRadius, globeToLocal, groundAt, iconRotation, insideFootprint, latFromMercatorY, lngFromMercatorX, lngLatToUnit, matchesFilter, mercatorMetersPerTile, mercatorX, mercatorY, mercatorZFromAltitude, metersPerPixel, metersPerTile, nextQualityDown, parseGlb, parseGlbAsync, parseGlyphs, parseHash, patchUV, pickBuilding, pickFill, pitchIntent, pixelsPerMeter, placeAlongLine, pointInRing, qualityFor, qualityProfile, raySphere, resolveTemplate, roundRing, sdfFromAlpha, shapeText, splitBucketKey, splitByGround, splitPolygons, styleWithTheme, tileOriginMeters, tileUrl, toLngLat, unitToLngLat, worldSize };
+export { type AnimationOptions, AssetLoader, type AssetLoaderOptions, BASE_SOURCE, BUILDING_HEIGHT_SCALE, BUILDING_VERTEX_STRIDE, type BuildingHit, type BuildingsMesh, CITY_STYLE, type CameraOptions, Circle, type CircleOptions, type CoverOptions, DEFAULT_ICONS, DEFAULT_LIGHT, DEFAULT_SHADOWS, DEFAULT_SKY, DEFAULT_STYLE, DepthTarget, type DeviceHints, EARTH_CIRCUMFERENCE, FILL_VERTEX_STRIDE, type Filter, type FitBoundsOptions, type FitViewport, type FogPlanes, GLOBE_MAX_PITCH, GLOBE_ZOOM_MAX, GLOBE_ZOOM_MIN, GLYPH_BORDER, GLYPH_SIZE, GROUND_SCALE, GeomType, type GestureOptions, type Glyph, type GlyphMetric, GlyphSource, GroundArrows, IconSource, IndoorMask, type Interpolated, LEVEL_LIMIT, LINE_VERTEX_STRIDE, type LayerPlan, LayerRenderer, type LightSpec, type LinePlacement, type LngLat, LngLatBounds, type LngLatLike, MAX_LATITUDE, MODEL_VERTEX_STRIDE, Map$1 as Map, type MapEvents, MapObject, type MapObjectOptions, type MapOptions, Marker, type MarkerOptions, Model, ModelLayer, type ModelMesh, type ModelOptions, type ModelPrimitive, ObjectManager, type ObjectPaint, type ObjectPart, type Padding, type PlacedGlyph, type PlacedSymbol, Polygon, type PolygonOptions, Polyline, type PolylineOptions, type PolylineSegment, Popup, type PopupOptions, type Projection, type QualityName, type QualityProfile, RELIEF_STYLE, RUNTIME_FILL_STRIDE, RUNTIME_LINE_STRIDE, RasterSource, type RasterSourceOptions, RasterTile, type RoundOptions, type RuntimeMesh, SDF_EDGE, SDF_PX, SOFT_STYLE, SPLIT_SEP, SURFACE_CUT_BLEED, SURFACE_LEVEL_SCALE, SURFACE_VERTEX_STRIDE, type ScreenPoint$1 as ScreenPoint, SdfAtlas, type ShadowSettings, type SkySpec, Style, type StyleLayerSpec, type StyleSpec, type SymbolHit, SymbolRenderer, THEMES, TILE_SIZE, type ThemeSpec, TileID, Transform, VectorTile, VectorTileFeature, VectorTileLayer, abbreviateStreet, addGround, altitudeFromMercatorZ, applyTheme, arrowLabelOffset, arrowVertices, buildRuntimeFill, buildRuntimeLine, cameraForBounds, circumferenceAtLatitude, clampLat, clampPixelRatio, clipLineToRect, coordinateDigits, coveringTiles, createGround, Map$1 as default, deviceHints, distToSegment, evaluateColor, evaluateNumber, extractFeature, featureLevel, fillFootprint, fogPlanes, footprintOf, formatHash, generateBuildings, generateFill, generateLine, generateSurface, generateSymbols, globeBasis, globeFlatMix, globeRadius, globeToLocal, groundAt, iconRotation, insideFootprint, latFromMercatorY, lngFromMercatorX, lngLatToUnit, matchesFilter, mercatorMetersPerTile, mercatorX, mercatorY, mercatorZFromAltitude, metersPerPixel, metersPerTile, nextQualityDown, parseGlb, parseGlbAsync, parseGlyphs, parseHash, patchUV, pickBuilding, pickFill, pitchIntent, pixelsPerMeter, placeAlongLine, pointInRing, qualityFor, qualityProfile, raySphere, resolveTemplate, roundRing, sdfFromAlpha, shapeText, splitBucketKey, splitByGround, splitPolygons, styleWithTheme, tileOriginMeters, tileUrl, toLngLat, unitToLngLat, worldSize };