osmgl 0.12.1 → 0.13.0

package/dist/osmgl.d.cts

@@ -1683,7 +1683,8 @@ interface SurfaceLayerSpec extends LayerBase {
     groundField?: boolean;
     bevelDrop?: number;
     paint: MaterialPaint & {
-        color: Interpolated<string>;
+        /** Цвет поверхности; `{ from, darken }` — «как у такого-то слоя» (см. `ColorFrom`). */
+        color: Interpolated<string> | ColorFrom;
         opacity?: Interpolated<number>;
         /** Насколько темнее борт и юбка, 0..1. */
         sideShade?: Interpolated<number>;
@@ -1691,8 +1692,11 @@ interface SurfaceLayerSpec extends LayerBase {
          * Цвет борта и юбки. По умолчанию у УТОПЛЕННОЙ поверхности это фон стиля —
          * то есть земля вокруг: стенка утопленной воды и есть берег, и красить её
          * водой значит обводить реку тёмной каймой.
+         *
+         * `{ from, darken }` — «как у такого-то слоя» (см. `ColorFrom`): так бордюр полотна берёт цвет
+         * обводки дорог из темы и меняется вместе с ней, а не остаётся одним хексом на все палитры.
          */
-        sideColor?: Interpolated<string>;
+        sideColor?: Interpolated<string> | ColorFrom;
         /**
          * Насколько борт освещается КАК ЗЕМЛЯ (0 — по своей нормали, 1 — по
          * вертикальной). У берега нормаль горизонтальная, света он почти не
@@ -1700,6 +1704,20 @@ interface SurfaceLayerSpec extends LayerBase {
          * умолчанию 1, и край берёт свет окружающей земли.
          */
         sideLight?: Interpolated<number>;
+        /**
+         * ТОН ПО ВЫСОТЕ: чем выше лежит верх поверхности, тем он светлее (> 0) или темнее (< 0).
+         *
+         * Уровни развязки читаются сверху, без наклона камеры: у Baidu нижняя дорога под эстакадой
+         * заметно темнее верхней, а по длине съезда тон меняется плавно (замер их кадров,
+         * `sdk/baydumap/RESEARCH.md` §6.4 в монорепозитории). Считается по высоте КАЖДОЙ вершины —
+         * профиль подъёма (`liftPath`) даёт градиент по съезду сам, без нарезки на куски.
+         *
+         * Доля смешивания с белым (или чёрным) на полной высоте [`liftToneHeight`], 0..1. Земля
+         * (верх ниже уровня слоя + четверти метра) не меняется — тема остаётся темой.
+         */
+        liftTone?: Interpolated<number>;
+        /** Высота, на которой тон набирает всю силу, метры. По умолчанию — `levelHeight` стиля или 8. */
+        liftToneHeight?: number;
     };
 }
 /**
@@ -2790,6 +2808,15 @@ declare class Tile {
     requestId: number;
     /** Ресурсы GPU по имени слоя — слой создаёт лениво, источник гарантированно чистит. */
     readonly buckets: Map<string, TileBucket>;
+    /**
+     * Сколько памяти держит разобранный тайл, байт.
+     *
+     * Считается ОДИН раз при приёме: складывать буферы каждой проверки бюджета значило бы обходить
+     * все слои всех тайлов на каждом кадре. Нужно это затем, что тайлы разного веса: тайл застройки
+     * центра города — это мегабайты, а тайл точек на том же зуме — десятки килобайт, и держать
+     * одинаковое ЧИСЛО тех и других (как делал кеш) — значит не знать, сколько памяти занято.
+     */
+    bytesHeld: number;
     constructor(id: TileID);
     /** Сырой тайл, каким он приехал: из него запросы берут свойства фич. */
     get raw(): ArrayBuffer | undefined;
@@ -2876,6 +2903,25 @@ declare class TileSource extends Evented<TileSourceEvents> {
     /** Отмена загрузок по своему протоколу: у них своя сигнализация, пул о них не знает. */
     private protocolAborts;
     /** Тайлы, которые слой должен нарисовать в этом кадре. */
+    /**
+     * Сколько памяти держат разобранные тайлы этого источника.
+     *
+     * Считается обходом кеша, а не счётчиком: счётчик пришлось бы править в полудюжине мест
+     * (приём, вытеснение, сброс данных, смена стиля), и разойдись он хоть раз — бюджет памяти
+     * молча перестал бы работать. Обход идёт раз на кадр по паре сотен записей.
+     */
+    get retainedBytes(): number;
+    /**
+     * Выбросить самый давний тайл, который сейчас не рисуют. Возвращает, сколько байт освободилось.
+     *
+     * Видимые не трогаем ни при каких обстоятельствах: выбросить то, что в кадре, — это дыра на
+     * экране вместо экономии.
+     *
+     * В ответе `-1` означает «выбрасывать нечего», а не ноль: пустой тайл (приехал без единого слоя)
+     * весит ноль байт, и путать «выбросил, но освободилось ноль» с «нечего выбрасывать» нельзя —
+     * на этом обрезка однажды останавливалась, не дойдя до толстых тайлов.
+     */
+    dropOldest(): number;
     get visibleTiles(): TileID[];
     /** Версия содержимого: меняется, когда приехал очередной тайл или сменился видимый набор. */
     get dataVersion(): number;
@@ -2983,6 +3029,95 @@ declare class TileSource extends Evented<TileSourceEvents> {
     destroy(): void;
 }
 
+/**
+ * СБОРКА ДОМОВ, РАЗРЕЗАННЫХ ГРАНИЦЕЙ ТАЙЛА.
+ *
+ * Тайл видит только свой кусок дома, и правильной геометрии из него не построить: скругление,
+ * фаска, стены и скатная крыша считаются по контуру, а у куска контур обрублен ложным ребром. Как
+ * ни выравнивай правила, на шве остаётся угловатость — разрез не край дома, и любая обработка,
+ * смотрящая на соседние вершины, на нём врёт.
+ *
+ * Собрать дом целиком можно только там, где видно ВСЕ его куски, — то есть здесь, на главном
+ * потоке, где известен весь загруженный набор тайлов. Сшивание делает `stitch.ts`, геометрию —
+ * тот же код, что и для обычных домов (`generateStitchedBuildings`), иначе сшитый дом отличался бы
+ * от соседних и мы поменяли бы шов на разнобой.
+ *
+ * ЧТО С КУСКАМИ. Воркер строит их как и раньше — это страховка: сшить удаётся не всегда, дом бывает
+ * длиннее загруженных тайлов. Куски успешно сшитых домов прячутся тем же механизмом, что и дома,
+ * заменённые 3D-моделью (`hiddenBuildings`), поэтому двойной отрисовки не возникает, а несшитые
+ * продолжают рисоваться по-старому.
+ *
+ * ЦЕНА. На паре тайлов Душанбе из 1364 домов границу задевают 45 — около 3 %. Пересборка идёт не
+ * каждый кадр, а только когда меняется состав загруженных тайлов.
+ */
+declare class SeamAssembler {
+    /** Сшитая геометрия по ключу тайла-хозяина: в его координатах она и построена. */
+    readonly meshes: Map<string, {
+        tile: TileID;
+        mesh: BuildingsMesh;
+    }>;
+    /** Дома, которые собраны: их куски надо спрятать — но только там, где они пошли в дело. */
+    readonly stitched: Set<number>;
+    /**
+     * Какие дома прятать В КАКОМ тайле: ключ тайла → номера домов.
+     *
+     * Прятать по одному лишь номеру дома нельзя. Замена собирается из тех кусков, что сейчас
+     * загружены, и стоит соседнему тайлу уйти из вида, как его кусок в сборку не попадает — а
+     * спрятан он всё равно был бы. На карте это выглядело так: ведёшь мышью, часть здания уезжает
+     * за край экрана и ПРОПАДАЕТ. Потайловый список это закрывает: кусок, не вошедший в сборку,
+     * продолжает рисоваться сам.
+     */
+    readonly hiddenByTile: Map<string, Set<number>>;
+    /**
+     * Тайлы-хозяева, чья геометрия сменилась в последнем `update`. Их буферы на видеокарте устарели.
+     *
+     * Пересобирать всё подряд нельзя: за панораму тайлы приезжают десятками, а меши сшитых домов
+     * меняются от силы у двух-трёх хозяев. Полная перезаливка стоила 40–70 мс на кадр — ровно те
+     * рывки, что видно при движении.
+     */
+    readonly changed: Set<string>;
+    /**
+     * Сколько домов собирать и сколько мешей строить ЗА ОДИН ЗАХОД. Ноль — без ограничения.
+     *
+     * Ставит карта по профилю устройства (`QualityProfile.seamBudget`). Разом весь набор — это
+     * стоп-кадр: замер на эмуляторе дал 125 мс на таком кадре, а состав загруженных тайлов при зуме
+     * и панораме меняется постоянно.
+     */
+    budget: number;
+    /**
+     * Осталась ли работа с прошлого захода.
+     *
+     * По нему рендер просит следующий кадр: без этого недоделанная сборка ждала бы, пока камеру
+     * тронут снова, — то есть шов остался бы неготовым на неподвижной карте.
+     */
+    pending: boolean;
+    /** Состав набора, на котором собирали. Не изменился — не пересобираем. */
+    private signature;
+    /** Из чего построен меш каждого хозяина: не изменилось — меш не трогаем. */
+    private meshSig;
+    /**
+     * Собранные дома, по номеру. Живут, пока дом виден хоть одному загруженному тайлу.
+     *
+     * Кеш нужен не только ради скорости. Без него объединение считалось бы заново на каждое движение
+     * камеры от того набора кусков, что есть прямо сейчас, — и здание «дышало» бы: то целое, то
+     * половина. Пока хоть один кусок на месте, дом остаётся тем же самым.
+     */
+    private cache;
+    /**
+     * Пересобрать то, что изменилось.
+     *
+     * Возвращает `true`, если геометрия поменялась и кешам пора обновиться.
+     */
+    update(source: TileSource, layerId: string, opts: {
+        zoom: number;
+        metersPerTile: number;
+        cornerRadius?: number;
+        cornerSegments?: number;
+    }): boolean;
+    /** Забыть собранное: после смены стиля или пересборки тайлов оно уже не про эту геометрию. */
+    reset(): void;
+}
+
 /**
  * Атлас SDF: глифы и иконки лежат в ОДНОЙ текстуре.
  *
@@ -5302,7 +5437,7 @@ declare class LayerRenderer {
      */
     hiddenBuildings: ReadonlySet<number>;
     /** Сборщик домов, разрезанных границей тайла. См. `layers/seams.ts`. */
-    private readonly seams;
+    readonly seams: SeamAssembler;
     /** GPU-буферы сшитых домов по ключу тайла-хозяина. */
     private seamGpu;
     /**
@@ -5740,8 +5875,12 @@ declare class LayerRenderer {
      * поток при панораме (46 МБ за 70 кадров, то есть 0.67 МБ на кадр). Остаток переносится на
      * следующий кадр, который тут же и заказывается: на глаз тайл достраивается за пару кадров, а
      * вместо провала в 75 мс остаётся ровный ход.
+     *
+     * ЧИСЛО БЕРЁТСЯ У ПРОФИЛЯ (`uploadBudget`), а не стоит константой: те же полтора мегабайта на
+     * телефоне стоят втрое дороже, и на нём это снова рывок — тот самый, что видно при загрузке
+     * дорог и домов на ходу.
      */
-    private static readonly UPLOAD_BUDGET;
+    uploadBudget: number;
     private uploadLeft;
     private uploadDeferred;
     private bucketFor;
@@ -6138,6 +6277,42 @@ interface QualityProfile {
      * с дискретной картой (до этой правки так и было: бюджет был константой на всех).
      */
     modelBudget: number;
+    /**
+     * Сколько байт геометрии за кадр уезжает в видеопамять.
+     *
+     * Тайлы приезжают пачками: при панораме в кадр разом въезжает несколько новых, и у каждого
+     * десяток слоёв. Заливка всей пачки разом — это и есть рывок: карта едет ровно, а раз в полсекунды
+     * замирает. Остаток переносится на следующий кадр, и тайл достраивается за пару кадров вместо
+     * одного провала.
+     *
+     * ПОЧЕМУ ЭТО ПРОФИЛЬ, А НЕ КОНСТАНТА. Байты одинаковы, а время на них — нет: полтора мегабайта
+     * стоят дюжину миллисекунд на ноутбуке с дискретной картой и втрое больше на телефоне, где та же
+     * заливка идёт через общую с процессором память. Постоянный бюджет на всех означает, что на
+     * телефоне при каждой загрузке дорог и домов кадр выпадает из шестидесяти герц — ровно на то и
+     * жалуются.
+     */
+    uploadBudget: number;
+    /**
+     * Сколько памяти отводится РАЗОБРАННЫМ ТАЙЛАМ ВСЕХ наборов, байт.
+     *
+     * Держать в кеше фиксированное ЧИСЛО тайлов на набор — значит не знать, сколько занято: тайл
+     * застройки центра это мегабайты, а тайл точек на том же зуме — десятки килобайт. Наборов у
+     * карты семь, и на полном профиле их кеши вместе съедали кучу приложения целиком: замер на
+     * эмуляторе 28.09.2026 — 330 сборок мусора за полминуты и падение с OutOfMemory посреди зума.
+     *
+     * Бюджет ОБЩИЙ, а не по набору: наборы соревнуются за одну и ту же память, и делить её поровну
+     * между основой и точками неправильно.
+     */
+    tileMemoryBudget: number;
+    /**
+     * Сколько домов, разрезанных границей тайла, собирается за кадр.
+     *
+     * Сборка идёт на потоке кадра, а состав загруженных тайлов при зуме и панораме меняется
+     * постоянно — то есть собирать приходится часто. Разом весь набор это стоп-кадр: замер на
+     * эмуляторе дал 125 мс на такой кадр. Остаток переносится на следующий кадр, и на глаз шов
+     * доводится за несколько кадров вместо одного провала.
+     */
+    seamBudget: number;
     /**
      * Упрощать геометрию тайла: без скругления углов и без объёма у плоских зон.
      *
@@ -6614,6 +6789,15 @@ declare function sdfFromAlpha(alpha: Uint8Array | Uint8ClampedArray, width: numb
     height: number;
 };
 
+/**
+ * Откуда раскладка берёт глифы.
+ *
+ * Интерфейс, а не сам `GlyphSource`: раскладке нужна от него ровно одна операция, а сверке порта
+ * нужен источник, набитый заранее, — без сети и без обещаний.
+ */
+interface GlyphLookup {
+    get(code: number): Glyph | undefined;
+}
 /** Один разложенный символ: где стоит и какой глиф рисовать. */
 interface ShapedGlyph {
     glyph: Glyph;
@@ -6638,7 +6822,7 @@ interface Shaped {
 /**
  * @param letterSpacing разрядка между буквами в единицах кегля 24 — см. `letterSpacingFor`
  */
-declare function shapeText(text: string, source: GlyphSource, maxLineChars?: number, letterSpacing?: number): Shaped | null;
+declare function shapeText(text: string, source: GlyphLookup, maxLineChars?: number, letterSpacing?: number): Shaped | null;
 
 /**
  * Сокращение родового слова в названии улицы: «улица Истаравшан» → «ул. Истаравшан».
@@ -7330,6 +7514,28 @@ interface RoadGraphOptions {
     ringMax?: number;
 }
 declare function buildRoadGraph(axes: RoadAxis[], options?: RoadGraphOptions): RoadGraph;
+declare function snapRoadEnds(axes: RoadAxis[], reach: number, 
+/**
+ * Последнее слово за вызывающим: конец оси `from` (голова или хвост) в точку (x, y) оси `to`.
+ * Нужен тому, кто знает высоты: у съезда и улицы под ним уровень в данных один и тот же.
+ */
+accept?: (from: number, atHead: boolean, to: number, x: number, y: number) => boolean): RoadAxis[];
+/**
+ * КОЛЬЦО — ОКРУЖНОСТЬЮ.
+ *
+ * Кольцевая развязка в данных — многоугольник из двух десятков точек, и лента по нему выходит
+ * гранёной: островок в середине — восьмиугольник (Шанхай, 121.4833, 31.2341). Замкнутая ось,
+ * которая и в самом деле почти круг, заменяется окружностью, подобранной по её точкам (Каса:
+ * наименьшие квадраты по x² + y² + Dx + Ey + F), с шагом `step` по дуге.
+ *
+ * «Почти круг» — это и форма (4πS/P² не меньше `CIRCULAR`), и разброс радиуса точек (не больше
+ * `RADIUS_SPREAD`): петля вокруг парковки тоже замкнута, но кругом её делать нельзя.
+ *
+ * Концы чужих осей, сидевшие в вершинах кольца, переезжают на окружность вместе с ними (на луч
+ * из центра), а их точки входят в окружность отсчётами — связь по графу не рвётся. Направление
+ * обхода сохраняется: у одностороннего кольца оно и есть направление движения.
+ */
+declare function roundRings(axes: RoadAxis[], maxLength: number, step?: number): RoadAxis[];
 
 /**
  * РАЗМЕТКА ПО ГРАФУ ДОРОГ.
@@ -7462,6 +7668,13 @@ interface MarkingOptions {
      * Стоп-линия отмеряется ОТ ПЕРЕХОДА, поэтому едет вместе с ним и остаётся к нему прижатой.
      */
     crossingAt?: (chain: RoadChain, index: number, node: number) => number | null;
+    /**
+     * СТОП-ЛИНИЯ НА ГЛАВНОЙ У Т-ПРИМЫКАНИЯ. `true` (как было) — на каждом подходе к перекрёстку;
+     * `false` — у узла на три луча улица, проходящая его насквозь (у её луча есть продолжение под
+     * 180° ± 30°), главная, и стоп-линии на ней нет: стоит только тот, кто выезжает сбоку. Иначе
+     * каждое примыкание двора перечёркивало проспект поперёк (Шанхай, 27.09.2026).
+     */
+    throughStop?: boolean;
 }
 declare function roadMarkings(graph: RoadGraph, options?: MarkingOptions): Marking[];
 
@@ -7880,6 +8093,9 @@ declare function roadSurfaces(graph: RoadGraph, options?: RoadSurfaceOptions): R
  *      Платит за это середина: у такой кривой она в полтора раза круче. Значит уклон в решателе
  *      берётся в полтора раза меньше — чтобы в самом крутом месте выйти ровно на заданный.
  *
+ *   4. (по опции `clearance`) Уточнение с ограничениями: зазор на пересечениях без общего узла,
+ *      уклон, общий узел, выравнивание соседних проезжих частей. См. `refine` в конце файла.
+ *
  * Считает в метрах, как и весь граф.
  */
 
@@ -7893,6 +8109,25 @@ interface RoadHeightOptions {
      * восьмидесяти. Это уклон в САМОМ КРУТОМ месте кривой, а не средний.
      */
     maxGrade?: number;
+    /**
+     * ЗАЗОР ПОД ЭСТАКАДОЙ, метры. Ноль — уточнение выключено, работают только шаги 1–3.
+     *
+     * Шаги 1–3 знают только граф: поднятое — наверх, от него по уклону вниз. О ПЕРЕСЕЧЕНИЯХ без общего
+     * узла они не знают ничего. Поэтому съезд, который идёт к дальней проезжей части моста и по пути
+     * проходит под ближней, набирал высоту от точки примыкания и протыкал ближний настил (развязка
+     * «Нового моста» в Худжанде, 27.09.2026). С зазором поверх шагов 1–3 работает шаг 4 — уточнение
+     * с ограничениями, см. `refine`.
+     */
+    clearance?: number;
+    /** Шаг отсчётов высоты вдоль цепочки при уточнении, в единицах графа. */
+    step?: number;
+    /**
+     * Насколько соседние параллельные проезжие части могут отстоять кромка от кромки, чтобы их
+     * выравнивало по высоте, в единицах графа.
+     */
+    alignGap?: number;
+    /** Число итераций уточнения. */
+    iterations?: number;
 }
 interface RoadHeights {
     /** Высота узла, метры. */
@@ -7913,6 +8148,128 @@ interface RoadHeights {
 }
 declare function roadHeights(graph: RoadGraph, options?: RoadHeightOptions): RoadHeights;
 
+/**
+ * ПОЛОТНО ДОРОГ СЕТКОЙ: ЛЕНТЫ ПО ГРАФУ И ПЯТНА УЗЛОВ, СРАЗУ В 3D.
+ *
+ * Прежний путь (`road-surface` → полигоны → слияние → поле высот `liftPath`) терял главное: ЧЬЯ ЭТО
+ * ТОЧКА. Лента, ставшая полигоном, уже не знает, какой вершине какое место оси соответствует, и
+ * высоту приходилось угадывать заново по «ближайшей оси». Все дефекты развязок жили на этом шаге:
+ * провал настила над хвостом соседа, смешивание осей разных уровней, стенки на торцах, зубцы
+ * слияния (27.09.2026).
+ *
+ * Здесь параметризация не теряется ни на одном шаге:
+ *
+ *   1. ПЕРЕГОН — лента по тройке «кромка — ось — кромка» (`roadEdges`). Высота каждой вершины —
+ *      `heights.at` СВОЕЙ оси в этом месте; полей и смешивания нет.
+ *
+ *   2. ЛЕНТА ОБРЕЗАЕТСЯ У УЗЛА ровно там, где бордюрная дуга радиуса `kerbRadius` касается её
+ *      кромки. Так и зазор до чужого полотна получается сам: у прямого перекрёстка это полуширина
+ *      поперечной улицы плюс радиус.
+ *
+ *   3. ПЯТНО УЗЛА — контур из торцов лент и дуг между соседними кромками (кубическая Безье,
+ *      касательная к обеим кромкам: то же, что дуга окружности, но точно в торцевые вершины).
+ *      Вершины на стыке с лентой ОБЩИЕ — ни щели, ни перекрытия по построению.
+ *
+ *   4. ГРУППЫ БЛИЗКИХ УЗЛОВ. Перекрёсток двух улиц с разделительной — это четыре узла в двадцати
+ *      метрах друг от друга, и короткие перемычки между ними после обрезки по дугам не помещаются
+ *      вовсе. Такие узлы сводятся в ОДНО пятно: перемычки уходят внутрь него, контур обходит все
+ *      лучи, выходящие из группы.
+ *
+ *   5. УЗКИЙ ПРОМЕЖУТОК между лентами одного уровня (проезжие части эстакады, идущие вплотную)
+ *      заливается: каждая лента доращивает свою кромку до середины щели. Иначе в щель видно землю
+ *      и стенки вниз, а у Baidu там сплошной настил.
+ *
+ *   6. ОБЪЁМ: верх, борт, бордюрный камень и низ. Борт и камень строятся ТОЛЬКО по внешнему
+ *      контуру — у торца, примыкающего к пятну, стенки нет, потому что там нет края; где снаружи
+ *      от кромки чужой асфальт той же высоты — тоже. Камень лежит внутри границы асфальта (как у
+ *      Baidu), его внутренняя линия у ленты и у пятна в общих вершинах одна и та же.
+ *
+ *   7. СЛИЯНИЯ НЕТ: эстакада и дорога под ней — разные ленты, кто сверху, решает буфер глубины.
+ *
+ * Считает в единицах графа (метрах). Отдаёт треугольники; во что их превратить — дело рендера.
+ */
+
+interface RoadMeshOptions {
+    /** Сколько добавить к полуширине проезжей части — свес бордюра, метры. */
+    widthExtra?: number;
+    /** Радиус бордюра на углу перекрёстка, метры. */
+    kerbRadius?: number;
+    /** Верх полотна над своей высотой — бордюр на земле, метры. */
+    elevation?: number;
+    /** Толщина настила: низ поднятого полотна на столько ниже верха, метры. */
+    deck?: number;
+    /** Шаг отсчётов вдоль ленты, метры: по нему идёт высота. */
+    step?: number;
+    /** Наименьший отступ торца от узла, метры. */
+    minCut?: number;
+    /**
+     * БОРДЮРНЫЙ КАМЕНЬ, метры: ширина поперёк и высота над асфальтом. Ноль — без камня, голый борт.
+     *
+     * Как у Baidu (кадр 四元桥 z20, наклон): камень лежит ВНУТРИ границы асфальта тонким белым
+     * ободом (≈ 2 px на z20 — 0.27 м при 7.42 px/м), его грань к дороге светло-серая, а наружная
+     * грань переходит в борт полотна. Внутри контура асфальта — поэтому и «только в границах
+     * асфальта»: наружу камень не выходит ни на сантиметр.
+     */
+    kerbWidth?: number;
+    kerbHeight?: number;
+    /**
+     * Перемычка между узлами короче этого уходит внутрь общего пятна, если после обрезки по дугам
+     * она не помещается, метры. Ноль — группы не собираются.
+     */
+    clusterLink?: number;
+    /** Промежуток между лентами одного уровня уже этого заливается, метры. Ноль — не заливается. */
+    fillGap?: number;
+    /** Собирать островки безопасности из дырок в асфальте. */
+    islands?: boolean;
+    /**
+     * ОТДАТЬ ПЛОСКИЙ КОНТУР АСФАЛЬТА (`outline`): объединение лент, пятен и полукруглых тупиков, где
+     * дырки-островки заменены их сглаженной формой. Для генератора тайлов: сетка там не нужна — в
+     * тайл идут плоские фигуры, а рисует их обычный слой поверхности.
+     */
+    outline?: boolean;
+    /** Пропустить цепочку (тоннели, пешеходное). */
+    skip?: (chain: number) => boolean;
+}
+/** Часть сетки: по ней рендер выбирает цвет. */
+declare const MESH_TOP = 0;
+declare const MESH_SIDE = 1;
+declare const MESH_BOTTOM = 2;
+/** Верх бордюрного камня. */
+declare const MESH_KERB_TOP = 3;
+/** Грань камня, обращённая к дороге. */
+declare const MESH_KERB_SIDE = 4;
+/** Верх островка безопасности. */
+declare const MESH_ISLAND = 5;
+interface RoadMesh {
+    /** x, y, z на вершину; x и y — единицы графа, z — метры. */
+    positions: Float64Array;
+    normals: Float32Array;
+    /** `MESH_TOP` / `MESH_SIDE` / `MESH_BOTTOM` / `MESH_KERB_*` на вершину. */
+    part: Uint8Array;
+    /** Высота полотна (без `elevation`) на вершину — для тона по высоте. */
+    height: Float32Array;
+    indices: Uint32Array;
+    ribbons: number;
+    patches: number;
+    /** Пятен, собранных из нескольких узлов, и перемычек, ушедших внутрь них. */
+    clusters: number;
+    links: number;
+    /** Отсчётов кромки, дорощенных до соседа. */
+    filled: number;
+    /** Островков безопасности, собранных из дырок в асфальте. */
+    islands: number;
+    /** Плоский контур асфальта (только с `outline`): внешний контур против часовой, дырки — по. */
+    outline?: {
+        outer: number[];
+        holes: number[][];
+    }[];
+    /** Отрезков бордюра, снятых потому, что снаружи чужой асфальт той же высоты. */
+    kerbSkipped: number;
+    /** Для отладки: по ленте [цепочка, длина, обрезка у головы, у хвоста, нужная у головы, у хвоста]. */
+    cuts: Float32Array;
+}
+declare function roadMesh(graph: RoadGraph, heights: RoadHeights, options?: RoadMeshOptions): RoadMesh;
+
 /**
  * МОСТ КАК СООРУЖЕНИЕ: продольный профиль и опоры.
  *
@@ -8558,6 +8915,31 @@ interface SurfaceMesh {
 declare const SURFACE_CUT_BLEED = 1;
 declare function generateSurface(layer: VectorTileLayer, extent: number, filter: Filter | undefined, opts: SurfaceOptions): SurfaceMesh | null;
 
+/**
+ * Здание, пересекающее границу тайла, приезжает В ОБОИХ — и каждый раз с
+ * буфером (у наших тайлов 64 единицы из 4096). В полосе перекрытия получаются
+ * ДВЕ копии одной крыши и одних стен на одной высоте, и они дерутся за глубину:
+ * на экране это мерцающая полоса ровно по стыку тайлов, тем шире, чем крупнее
+ * зум. Проверено на Душанбе: из 2700 зданий тайла 165 лежат ещё и в соседнем.
+ *
+ * Лечится обрезкой по квадрату тайла (Сазерленд — Ходжман). Тот же приём у
+ * Mapbox: в `fill_extrusion_bucket` кольца, целиком лежащие за границей,
+ * выбрасываются с прямой пометкой «они определены в тайле по ту сторону».
+ *
+ * Стены на линии разреза при этом НЕ строятся — см. `isCutEdge`: разрез не
+ * стена, у соседнего тайла там продолжение дома.
+ */
+/**
+ * Запас за границей тайла, в единицах тайла.
+ *
+ * Источник отдаёт геометрию с буфером в 4 пикселя из 256 на тайл — здесь это та же величина, но в
+ * единицах тайла. Резать по квадрату С ЗАПАСОМ, а не по самому квадрату, нужно затем, чтобы линия
+ * разреза не попадала в кадр: любая обработка, смотрящая на соседние рёбра (фаска, борта,
+ * скругление), у соседних тайлов на разрезе расходится, а признака «это ребро ненастоящее» в
+ * векторных тайлах нет — так записано и в их спецификации.
+ */
+declare const cutMargin: (extent: number) => number;
+
 /**
  * Объединение полигонов слоя в один контур — до построения меша.
  *
@@ -9339,6 +9721,18 @@ declare class Map$1 extends Evented<MapEvents> {
     calculateCameraOptionsFromTo(from: LngLatLike, altitudeFrom: number, to: LngLatLike, altitudeTo?: number): CameraOptions & {
         elevation: number;
     };
+    /**
+     * ДЕРЖАТЬ РАЗОБРАННЫЕ ТАЙЛЫ В ПРЕДЕЛАХ БЮДЖЕТА ПАМЯТИ.
+     *
+     * Кеш каждого набора считает ТАЙЛЫ, а тратится ПАМЯТЬ, и вес тайла отличается на два порядка:
+     * застройка центра — мегабайты, точки — десятки килобайт. Наборов у карты семь, и вместе они
+     * съедали всю кучу приложения (см. `tileMemoryBudget`).
+     *
+     * Выбрасываем у САМОГО ТОЛСТОГО набора и по одному: так первым худеет тот, кто занял больше
+     * всех, а не тот, кому не повезло оказаться в списке первым. Видимые тайлы не трогаются вовсе —
+     * если выбрасывать нечего, выходим и живём с перерасходом до следующего кадра.
+     */
+    private trimTileMemory;
     /** Зум, прилипший к шагу `zoomSnap`. */
     private snapZoom;
     private stepAnimation;
@@ -9798,6 +10192,15 @@ declare class Map$1 extends Evented<MapEvents> {
         profile: QualityProfile;
         pixelRatio: number;
     };
+    /**
+     * Настройки профиля, которые живут в рендере.
+     *
+     * Отдельным методом, потому что зовётся ДВАЖДЫ: при заведении карты и при каждой смене профиля.
+     * Без первого раза карта, заведённая на слабом устройстве, рисовала бы первым делом по
+     * настройкам самого сильного — детализация, тени и бюджеты остались бы от значений по
+     * умолчанию, пока профиль не сменится.
+     */
+    private applyRendererQuality;
     /**
      * @param keepLook не трогать то, что видно НАВСЕГДА, — плотность буфера и упрощение геометрии.
      *   Так приходит автоснижение: см. `checkFrameBudget`.
@@ -9964,4 +10367,4 @@ declare class Map$1 extends Evented<MapEvents> {
     destroy(): void;
 }
 
-export { type AnimationOptions, type ArrowSize, AssetLoader, type AssetLoaderOptions, AttributionControl, type AxisChain, BASE_SOURCE, BUILDING_HEIGHT_SCALE, BUILDING_POS_SCALE, BUILDING_VERTEX_STRIDE, BoxZoomHandler, type BridgeProfile, type BuildingHit, type BuildingsMesh, CITY_STYLE, type CameraOptions, type CameraUpdate, Circle, type CircleOptions, type ControlPosition, CooperativeGesturesHandler, type CoverOptions, type CustomLayer, DATA_PAINT_STRIDE, DEFAULT_ICONS, DEFAULT_LIGHT, DEFAULT_SHADOWS, DEFAULT_SKY, DEFAULT_STYLE, type DataPaintSpec, type DemEncoding, DemSource, type DemSourceOptions, DemTile, DemTileEntry, DepthTarget, type DeviceHints, EARTH_CIRCUMFERENCE, type ExprContext, type ExprValue, FILL_VERTEX_STRIDE, FeaturePaint, type Filter, type FitBoundsOptions, type FitViewport, type FogPlanes, FullscreenControl, GLOBE_MAX_PITCH, GLOBE_ZOOM_MAX, GLOBE_ZOOM_MIN, GLYPH_BORDER, GLYPH_SIZE, GROUND_SCALE, type GeoJSONData, type GeoJSONFeature, type GeoJSONFeatureCollection, type GeoJSONGeometry, GeoJSONSource, GeolocateControl, GeomType, GestureHandler, type GestureOptions, GlobeControl, type Glyph, type GlyphMetric, GlyphSource, type GpuClass, GroundArrows, type IControl, IconSource, ImageManager, IndoorMask, type Interpolated, type Junctions, LEVEL_LIMIT, LINE_VERTEX_STRIDE, type LaneArrow, type LaneGuide, type LaneGuideOptions, type LayerPlan, LayerRenderer, type LiftField, type LightSpec, type LinePlacement, type LngLat, LngLatBounds, type LngLatLike, LogoControl, MAX_GRADE, MAX_LATITUDE, MIN_PIER_HEIGHT_METERS, MODEL_VERTEX_STRIDE, Map$1 as Map, type MapEvents, MapObject, type MapObjectOptions, type MapOptions, Marker, type MarkerOptions, type Marking, type MarkingKind, type MarkingOptions, type MarkingRing, type MediaCoordinates, type MediaKind, MediaSource, Model, ModelLayer, type ModelMesh, type ModelOptions, type ModelPrimitive, NavigationControl, ObjectManager, type ObjectPaint, type ObjectPart, PIER_SPACING_METERS, type Padding, type Pier, type PierOptions, type PlacedGlyph, type PlacedSymbol, Polygon, type PolygonOptions, type PolygonPiece, Polyline, type PolylineOptions, type PolylineSegment, Popup, type PopupOptions, type Projection, type ProtocolHandler, type QualityChange, QualityGovernor, type QualityName, type QualityProfile, type QueriedFeature, type QueryGeometry, RELIEF_STYLE, ROAD_SIGNS, RUNTIME_FILL_STRIDE, RUNTIME_LINE_STRIDE, type RampOptions, RasterSource, type RasterSourceOptions, RasterTile, type RenderedQueryOptions, type RoadAxis, type RoadChain, type RoadEdges, type RoadGraph, type RoadGraphOptions, type RoadHeightOptions, type RoadHeights, type RoadNode, type RoadRay, type RoadSourceEdges, type RoadSurface, type RoadSurfaceOptions, type RoundOptions, type RuntimeMesh, SDF_EDGE, SDF_PX, SIGN_SIZE, SOFT_STYLE, SPLIT_SEP, SURFACE_CUT_BLEED, SURFACE_LEVEL_SCALE, SURFACE_VERTEX_STRIDE, ScaleControl, type ScreenPoint$1 as ScreenPoint, SdfAtlas, type ShadowSettings, type SkySpec, Style, type StyleImage, type StyleImageData, type StyleImageOptions, type StyleLayerSpec, type StyleSpec, type SymbolHit, SymbolRenderer, TAPER_METERS, TERRAIN_STYLE, THEMES, TILE_SIZE, type TaperedWidth, TerrainControl, type ThemeSpec, type TileAddress, TileID, Transform, type TransformConstrain, type TransformRequest, VectorTile, VectorTileFeature, VectorTileLayer, abbreviateStreet, addGround, altitudeFromMercatorZ, applyTheme, arrowLabelOffset, arrowVertices, bridgePiers, bridgeProfile, buildRoadGraph, buildRuntimeFill, buildRuntimeLine, cameraForBounds, chainAxes, circumferenceAtLatitude, clampLat, clampPixelRatio, classifyRenderer, clipLineToRect, coordinateDigits, coveringTiles, createGround, Map$1 as default, densifyLine, deviceHints, distToSegment, evaluateColor, evaluateExpression, evaluateNumber, expressionColor, expressionNumber, extractFeature, featureDrivenPaint, featureLevel, fillFootprint, fogPlanes, footprintOf, formatHash, generateBuildings, generateFill, generateLine, generateSurface, generateSymbols, globeBasis, globeFlatMix, globeRadius, globeToLocal, groundAt, iconRotation, insideFootprint, isExpression, junctionIndex, laneArrow, laneGuides, latFromMercatorY, liftFields, lngFromMercatorX, lngLatToUnit, makeFeaturePaint, matchesFilter, mercatorMetersPerTile, mercatorX, mercatorY, mercatorZFromAltitude, metersPerPixel, metersPerTile, needsDataPaint, nextQualityDown, parseGlb, parseGlbAsync, parseGlyphs, parseHash, parseLift, patchUV, pickBuilding, pickFill, pitchIntent, pixelsPerMeter, placeAlongLine, placeMarking, pointInRing, qualityFor, qualityProfile, queryRendered, querySource, raySphere, refineLine, relaxAngle, relaxCurvature, resolveTemplate, ribbonFromEdges, ribbonRing, ribbonShape, ringEdges, roadEdges, roadHeights, roadMarkings, roadSurfaces, roundLine, roundRing, sdfFromAlpha, shapeText, speedSign, splitBucketKey, splitByGround, splitPolygons, stitchPieces, stopLine, styleWithTheme, taperedWidth, tileOriginMeters, tileUrl, toLngLat, unitToLngLat, unpackVector, waffle, worldSize, zebra };
+export { type AnimationOptions, type ArrowSize, AssetLoader, type AssetLoaderOptions, AttributionControl, type AxisChain, BASE_SOURCE, BUILDING_HEIGHT_SCALE, BUILDING_POS_SCALE, BUILDING_VERTEX_STRIDE, BoxZoomHandler, type BridgeProfile, type BuildingHit, type BuildingsMesh, CITY_STYLE, type CameraOptions, type CameraUpdate, Circle, type CircleOptions, type ControlPosition, CooperativeGesturesHandler, type CoverOptions, type CustomLayer, DATA_PAINT_STRIDE, DEFAULT_ICONS, DEFAULT_LIGHT, DEFAULT_SHADOWS, DEFAULT_SKY, DEFAULT_STYLE, type DataPaintSpec, type DemEncoding, DemSource, type DemSourceOptions, DemTile, DemTileEntry, DepthTarget, type DeviceHints, EARTH_CIRCUMFERENCE, type ExprContext, type ExprValue, FILL_VERTEX_STRIDE, FeaturePaint, type Filter, type FitBoundsOptions, type FitViewport, type FogPlanes, FullscreenControl, GLOBE_MAX_PITCH, GLOBE_ZOOM_MAX, GLOBE_ZOOM_MIN, GLYPH_BORDER, GLYPH_SIZE, GROUND_SCALE, type GeoJSONData, type GeoJSONFeature, type GeoJSONFeatureCollection, type GeoJSONGeometry, GeoJSONSource, GeolocateControl, GeomType, GestureHandler, type GestureOptions, GlobeControl, type Glyph, type GlyphMetric, GlyphSource, type GpuClass, GroundArrows, type IControl, IconSource, ImageManager, IndoorMask, type Interpolated, type Junctions, LEVEL_LIMIT, LINE_VERTEX_STRIDE, type LaneArrow, type LaneGuide, type LaneGuideOptions, type LayerPlan, LayerRenderer, type LiftField, type LightSpec, type LinePlacement, type LngLat, LngLatBounds, type LngLatLike, LogoControl, MAX_GRADE, MAX_LATITUDE, MESH_BOTTOM, MESH_ISLAND, MESH_KERB_SIDE, MESH_KERB_TOP, MESH_SIDE, MESH_TOP, MIN_PIER_HEIGHT_METERS, MODEL_VERTEX_STRIDE, Map$1 as Map, type MapEvents, MapObject, type MapObjectOptions, type MapOptions, Marker, type MarkerOptions, type Marking, type MarkingKind, type MarkingOptions, type MarkingRing, type MediaCoordinates, type MediaKind, MediaSource, Model, ModelLayer, type ModelMesh, type ModelOptions, type ModelPrimitive, NavigationControl, ObjectManager, type ObjectPaint, type ObjectPart, PIER_SPACING_METERS, type Padding, type Pier, type PierOptions, type PlacedGlyph, type PlacedSymbol, Polygon, type PolygonOptions, type PolygonPiece, Polyline, type PolylineOptions, type PolylineSegment, Popup, type PopupOptions, type Projection, type ProtocolHandler, type QualityChange, QualityGovernor, type QualityName, type QualityProfile, type QueriedFeature, type QueryGeometry, RELIEF_STYLE, ROAD_SIGNS, RUNTIME_FILL_STRIDE, RUNTIME_LINE_STRIDE, type RampOptions, RasterSource, type RasterSourceOptions, RasterTile, type RenderedQueryOptions, type RoadAxis, type RoadChain, type RoadEdges, type RoadGraph, type RoadGraphOptions, type RoadHeightOptions, type RoadHeights, type RoadMesh, type RoadMeshOptions, type RoadNode, type RoadRay, type RoadSourceEdges, type RoadSurface, type RoadSurfaceOptions, type RoundOptions, type RuntimeMesh, SDF_EDGE, SDF_PX, SIGN_SIZE, SOFT_STYLE, SPLIT_SEP, SURFACE_CUT_BLEED, SURFACE_LEVEL_SCALE, SURFACE_VERTEX_STRIDE, ScaleControl, type ScreenPoint$1 as ScreenPoint, SdfAtlas, type ShadowSettings, type SkySpec, Style, type StyleImage, type StyleImageData, type StyleImageOptions, type StyleLayerSpec, type StyleSpec, type SymbolHit, SymbolRenderer, TAPER_METERS, TERRAIN_STYLE, THEMES, TILE_SIZE, type TaperedWidth, TerrainControl, type ThemeSpec, type TileAddress, TileID, Transform, type TransformConstrain, type TransformRequest, VectorTile, VectorTileFeature, VectorTileLayer, abbreviateStreet, addGround, altitudeFromMercatorZ, applyTheme, arrowLabelOffset, arrowVertices, bridgePiers, bridgeProfile, buildRoadGraph, buildRuntimeFill, buildRuntimeLine, cameraForBounds, chainAxes, circumferenceAtLatitude, clampLat, clampPixelRatio, classifyRenderer, clipLineToRect, coordinateDigits, coveringTiles, createGround, cutMargin, Map$1 as default, densifyLine, deviceHints, distToSegment, evaluateColor, evaluateExpression, evaluateNumber, expressionColor, expressionNumber, extractFeature, featureDrivenPaint, featureLevel, fillFootprint, fogPlanes, footprintOf, formatHash, generateBuildings, generateFill, generateLine, generateSurface, generateSymbols, globeBasis, globeFlatMix, globeRadius, globeToLocal, groundAt, iconRotation, insideFootprint, isExpression, junctionIndex, laneArrow, laneGuides, latFromMercatorY, liftFields, lngFromMercatorX, lngLatToUnit, makeFeaturePaint, matchesFilter, mercatorMetersPerTile, mercatorX, mercatorY, mercatorZFromAltitude, metersPerPixel, metersPerTile, needsDataPaint, nextQualityDown, parseGlb, parseGlbAsync, parseGlyphs, parseHash, parseLift, patchUV, pickBuilding, pickFill, pitchIntent, pixelsPerMeter, placeAlongLine, placeMarking, pointInRing, qualityFor, qualityProfile, queryRendered, querySource, raySphere, refineLine, relaxAngle, relaxCurvature, resolveTemplate, ribbonFromEdges, ribbonRing, ribbonShape, ringEdges, roadEdges, roadHeights, roadMarkings, roadMesh, roadSurfaces, roundLine, roundRing, roundRings, sdfFromAlpha, shapeText, snapRoadEnds, speedSign, splitBucketKey, splitByGround, splitPolygons, stitchPieces, stopLine, styleWithTheme, taperedWidth, tileOriginMeters, tileUrl, toLngLat, unitToLngLat, unpackVector, waffle, worldSize, zebra };