osmgl 0.2.0 → 0.4.0

package/dist/osmgl.d.cts

@@ -618,6 +618,13 @@ declare class Context {
     constructor(gl: WebGL2RenderingContext);
     useProgram(program: WebGLProgram | null): boolean;
     bindVAO(vao: WebGLVertexArrayObject | null): void;
+    /**
+     * Куда уходит «экранный» кадр. По умолчанию `null` — канва. Диагностика
+     * подменяет его на свой буфер: проходы внутри рендера (тени, пикинг)
+     * возвращаются с bindFramebuffer(null), и без этой подмены весь кадр после
+     * первого же такого прохода уходил бы мимо буфера.
+     */
+    screen: WebGLFramebuffer | null;
     bindFramebuffer(fb: WebGLFramebuffer | null): void;
     bindTexture(unit: number, texture: WebGLTexture | null, target?: number): void;
     viewport(x: number, y: number, w: number, h: number): void;
@@ -688,6 +695,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 +852,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>;
         /**
          * Уровень полотна в МЕТРАХ — для рельефных вариантов карты: дорожка внутри
          * приподнятого парка должна лежать на нём, а не тонуть под ним. Меняется
@@ -1349,6 +1402,13 @@ interface LayerPlan {
     maxzoom: number;
     /** Разбить слой на меши по значению свойства (этажи — см. `LayerBase.splitBy`). */
     splitBy?: string;
+    /**
+     * Слой входит в СЕТЬ (`LineLayerSpec.network`): меш бьётся по уровням пересечения.
+     *
+     * Воркеру важно не имя сети, а сам факт: по уровню он раскладывает геометрию, а порядок
+     * расставляет уже рендер.
+     */
+    network?: string;
     /** Скругление углов в метрах — геометрия, поэтому едет в воркер. */
     cornerRadius?: number;
     cornerSegments?: number;
@@ -1616,6 +1676,14 @@ interface LoadedResponse {
      * этажи вообще есть в этом здании.
      */
     splits?: Record<string, (string | number)[]>;
+    /**
+     * Уровни пересечения, встретившиеся в этом тайле (см. `generators/level`), по возрастанию.
+     *
+     * Дорожная сеть рисуется НЕ по слоям, а по уровням: сначала всё, что под землёй, потом земля,
+     * потом эстакады. Какие уровни в тайле есть, знает только тот, кто его разобрал, — рендеру
+     * перебирать все возможные значения было бы дороже, чем передать список.
+     */
+    levels?: number[];
     timing: {
         fetchMs: number;
         parseMs: number;
@@ -3715,6 +3783,18 @@ declare class LayerRenderer {
     private applyMaterial;
     private drawFill;
     private drawLine;
+    /**
+     * СЕТЬ ЦЕЛИКОМ, по уровням пересечения (см. `LineLayerSpec.network`).
+     *
+     * Обычный слой рисуется на своём месте в стиле. Сеть так рисовать нельзя: обводка эстакады
+     * должна лежать поверх ПОЛОТНА улицы под ней, а полотно улицы в стиле идёт позже обводок.
+     * Поэтому вся сеть рисуется одним куском на месте своего первого слоя, и снаружи внутрь порядок
+     * такой: уровень (тоннели → земля → эстакады), а внутри уровня — обычный порядок слоёв.
+     *
+     * Какие уровни в кадре есть, считаем по видимым тайлам: в обычном городе это один нулевой, и
+     * тогда всё сводится к прежней отрисовке слой за слоем.
+     */
+    private drawNetwork;
     /**
      * Подсветка выбранного здания.
      *
@@ -4297,7 +4377,22 @@ declare function clipLineToRect(line: ScreenPoint[], width: number, height: numb
  */
 declare const BUILDING_VERTEX_STRIDE = 18;
 /** Множитель упаковки высоты в Uint16. */
-declare const BUILDING_HEIGHT_SCALE = 4;
+declare const BUILDING_HEIGHT_SCALE = 32;
+/**
+ * Множитель упаковки ПОЛОЖЕНИЯ вершины: сколько единиц Int16 приходится на единицу тайла.
+ *
+ * Было единица — то есть 0.47 м на z14, потому что координаты в MVT целые и вершину писали как
+ * есть. Пока углы дома были прямыми, этого хватало: вершина и так стояла в узле сетки. Со
+ * СКРУГЛЕНИЕМ хватать перестало — дуга радиусом 1.6 м это семь точек в пределах трёх единиц тайла,
+ * и округление сажает их на ту же сетку: вместо дуги выходит лесенка со ступенью в полметра, она же
+ * «угловатость» на ближнем зуме.
+ *
+ * Восемь единиц на тайловую — это 5.9 см, и дуга снова читается дугой. Потолок: тайл 0..4096, при
+ * ×8 это 0..32768, и последнее значение на единицу больше, чем помещается в Int16, — оно
+ * прижимается (`clampI16`). Ошибка при этом 6 см и только у вершины, стоящей ровно на дальней
+ * границе тайла.
+ */
+declare const BUILDING_POS_SCALE = 8;
 interface BuildingsMesh {
     vertices: ArrayBuffer;
     indices: ArrayBuffer;
@@ -4722,11 +4817,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, 
 /** Метров в единице тайла. Ноль — плавный переход ширины на стыках не строится. */
-metersPerUnit?: number): LineMesh | null;
+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;
 
 /**
  * Положение камеры в адресе страницы.
@@ -5676,10 +5807,19 @@ declare class Map$1 extends Evented<MapEvents> {
     };
     /** Просит нарисовать кадр. Движок рисует по требованию, а не постоянно. */
     triggerRepaint(): void;
+    private debugFB;
+    /**
+     * Рисует один кадр в float-буфер и возвращает прямоугольник пикселей.
+     * `x`, `y` — в координатах GL (снизу вверх), размеры в пикселях канвы.
+     */
+    debugFloatPixels(x: number, y: number, w: number, h: number): {
+        data: Float32Array;
+        format: string;
+    } | null;
     private renderFrame;
     private stopFrameLoop;
     get isLoaded(): boolean;
     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_POS_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

@@ -618,6 +618,13 @@ declare class Context {
     constructor(gl: WebGL2RenderingContext);
     useProgram(program: WebGLProgram | null): boolean;
     bindVAO(vao: WebGLVertexArrayObject | null): void;
+    /**
+     * Куда уходит «экранный» кадр. По умолчанию `null` — канва. Диагностика
+     * подменяет его на свой буфер: проходы внутри рендера (тени, пикинг)
+     * возвращаются с bindFramebuffer(null), и без этой подмены весь кадр после
+     * первого же такого прохода уходил бы мимо буфера.
+     */
+    screen: WebGLFramebuffer | null;
     bindFramebuffer(fb: WebGLFramebuffer | null): void;
     bindTexture(unit: number, texture: WebGLTexture | null, target?: number): void;
     viewport(x: number, y: number, w: number, h: number): void;
@@ -688,6 +695,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 +852,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>;
         /**
          * Уровень полотна в МЕТРАХ — для рельефных вариантов карты: дорожка внутри
          * приподнятого парка должна лежать на нём, а не тонуть под ним. Меняется
@@ -1349,6 +1402,13 @@ interface LayerPlan {
     maxzoom: number;
     /** Разбить слой на меши по значению свойства (этажи — см. `LayerBase.splitBy`). */
     splitBy?: string;
+    /**
+     * Слой входит в СЕТЬ (`LineLayerSpec.network`): меш бьётся по уровням пересечения.
+     *
+     * Воркеру важно не имя сети, а сам факт: по уровню он раскладывает геометрию, а порядок
+     * расставляет уже рендер.
+     */
+    network?: string;
     /** Скругление углов в метрах — геометрия, поэтому едет в воркер. */
     cornerRadius?: number;
     cornerSegments?: number;
@@ -1616,6 +1676,14 @@ interface LoadedResponse {
      * этажи вообще есть в этом здании.
      */
     splits?: Record<string, (string | number)[]>;
+    /**
+     * Уровни пересечения, встретившиеся в этом тайле (см. `generators/level`), по возрастанию.
+     *
+     * Дорожная сеть рисуется НЕ по слоям, а по уровням: сначала всё, что под землёй, потом земля,
+     * потом эстакады. Какие уровни в тайле есть, знает только тот, кто его разобрал, — рендеру
+     * перебирать все возможные значения было бы дороже, чем передать список.
+     */
+    levels?: number[];
     timing: {
         fetchMs: number;
         parseMs: number;
@@ -3715,6 +3783,18 @@ declare class LayerRenderer {
     private applyMaterial;
     private drawFill;
     private drawLine;
+    /**
+     * СЕТЬ ЦЕЛИКОМ, по уровням пересечения (см. `LineLayerSpec.network`).
+     *
+     * Обычный слой рисуется на своём месте в стиле. Сеть так рисовать нельзя: обводка эстакады
+     * должна лежать поверх ПОЛОТНА улицы под ней, а полотно улицы в стиле идёт позже обводок.
+     * Поэтому вся сеть рисуется одним куском на месте своего первого слоя, и снаружи внутрь порядок
+     * такой: уровень (тоннели → земля → эстакады), а внутри уровня — обычный порядок слоёв.
+     *
+     * Какие уровни в кадре есть, считаем по видимым тайлам: в обычном городе это один нулевой, и
+     * тогда всё сводится к прежней отрисовке слой за слоем.
+     */
+    private drawNetwork;
     /**
      * Подсветка выбранного здания.
      *
@@ -4297,7 +4377,22 @@ declare function clipLineToRect(line: ScreenPoint[], width: number, height: numb
  */
 declare const BUILDING_VERTEX_STRIDE = 18;
 /** Множитель упаковки высоты в Uint16. */
-declare const BUILDING_HEIGHT_SCALE = 4;
+declare const BUILDING_HEIGHT_SCALE = 32;
+/**
+ * Множитель упаковки ПОЛОЖЕНИЯ вершины: сколько единиц Int16 приходится на единицу тайла.
+ *
+ * Было единица — то есть 0.47 м на z14, потому что координаты в MVT целые и вершину писали как
+ * есть. Пока углы дома были прямыми, этого хватало: вершина и так стояла в узле сетки. Со
+ * СКРУГЛЕНИЕМ хватать перестало — дуга радиусом 1.6 м это семь точек в пределах трёх единиц тайла,
+ * и округление сажает их на ту же сетку: вместо дуги выходит лесенка со ступенью в полметра, она же
+ * «угловатость» на ближнем зуме.
+ *
+ * Восемь единиц на тайловую — это 5.9 см, и дуга снова читается дугой. Потолок: тайл 0..4096, при
+ * ×8 это 0..32768, и последнее значение на единицу больше, чем помещается в Int16, — оно
+ * прижимается (`clampI16`). Ошибка при этом 6 см и только у вершины, стоящей ровно на дальней
+ * границе тайла.
+ */
+declare const BUILDING_POS_SCALE = 8;
 interface BuildingsMesh {
     vertices: ArrayBuffer;
     indices: ArrayBuffer;
@@ -4722,11 +4817,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, 
 /** Метров в единице тайла. Ноль — плавный переход ширины на стыках не строится. */
-metersPerUnit?: number): LineMesh | null;
+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;
 
 /**
  * Положение камеры в адресе страницы.
@@ -5676,10 +5807,19 @@ declare class Map$1 extends Evented<MapEvents> {
     };
     /** Просит нарисовать кадр. Движок рисует по требованию, а не постоянно. */
     triggerRepaint(): void;
+    private debugFB;
+    /**
+     * Рисует один кадр в float-буфер и возвращает прямоугольник пикселей.
+     * `x`, `y` — в координатах GL (снизу вверх), размеры в пикселях канвы.
+     */
+    debugFloatPixels(x: number, y: number, w: number, h: number): {
+        data: Float32Array;
+        format: string;
+    } | null;
     private renderFrame;
     private stopFrameLoop;
     get isLoaded(): boolean;
     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_POS_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 };