osmgl 0.9.2 → 0.10.0

package/dist/osmgl.d.cts

@@ -1069,6 +1069,17 @@ interface FillExtrusionLayerSpec extends LayerBase {
          * контрастом на фасаде, и дом читается сеткой линий, а не объёмом.
          */
         seamStrength?: Interpolated<number>;
+        /**
+         * ЛЁД, 0..1. Ноль — обычный матовый дом.
+         *
+         * Настоящий лёд выдают две вещи, и обе видно на 3D-домах Baidu: кромка светится тем сильнее,
+         * чем острее угол взгляда к грани (у стекла и льда так отражается небо), и низ стены светлее
+         * верха — свет уходит в толщу и рассеивается. Ни то, ни другое не задать цветом: это зависит
+         * от камеры и от высоты точки, то есть считается в шейдере.
+         *
+         * Цвет при этом остаётся за темой: ручка только добавляет блик и градиент поверх него.
+         */
+        ice?: Interpolated<number>;
         /**
          * Доля светящихся окон, 0..1 — для ночных тем. Какие именно окна горят,
          * решает хеш ячейки, поэтому при движении камеры свет не «бегает».
@@ -1141,10 +1152,15 @@ interface SymbolLayerSpec extends LayerBase {
         iconTextGap?: number;
         /**
          * Где стоит иконка относительно подписи: `top` — над ней по центру (так у
-         * Mapbox Standard и у Яндекса: значок ровно над точкой объекта), `left` —
-         * сбоку, плотнее по вертикали.
+         * Mapbox Standard и у Яндекса: значок ровно над точкой объекта), `left` и
+         * `right` — сбоку, плотнее по вертикали, `behind` — плашка под подписью.
+         *
+         * `auto` — ПЕРЕБОР сторон: подпись справа от значка, занято — слева, занято — под ним. Так
+         * подписей на плотной карте помещается заметно больше: подпись, которой не нашлось места с
+         * одной стороны, находит его с другой вместо того, чтобы пропасть. Работает только с
+         * `iconFrame: 'pin'` — значок при этом остаётся остриём на объекте.
          */
-        iconPlacement?: 'top' | 'left' | 'behind';
+        iconPlacement?: 'top' | 'left' | 'right' | 'behind' | 'auto';
         /**
          * Как ставится подпись: `point` — горизонтально у точки привязки (по
          * умолчанию), `line` — вдоль линии объекта, изгибаясь по ней.
@@ -1186,8 +1202,13 @@ interface SymbolLayerSpec extends LayerBase {
          * Это ОТДЕЛЬНЫЙ значок под иконкой, а не обводка: обводка у нас общая с
          * текстом (одна программа), и «жирный контур» вокруг пиктограммы выглядит
          * грязно, а кружок — фигура со своей заливкой и своей рамкой.
+         *
+         * `pin` — та же подложка, но с остриём вниз. Отличие не в рисунке, а в ТОЧКЕ ПРИВЯЗКИ: у
+         * кружка на объекте стоит его середина, у булавки — остриё. Поэтому с булавкой подпись можно
+         * увести вбок (`iconPlacement: 'left'`), не теряя, к чему она относится: показывает не значок
+         * целиком, а его кончик. Так устроены POI у Baidu Maps.
          */
-        iconFrame?: 'circle' | 'none';
+        iconFrame?: 'circle' | 'pin' | 'none';
         /** Диаметр подложки относительно значка. */
         iconFrameScale?: number;
         /**
@@ -1253,8 +1274,16 @@ interface SymbolLayerSpec extends LayerBase {
         arrowGap?: Interpolated<number>;
     };
     paint: {
-        color: Interpolated<string>;
-        haloColor?: Interpolated<string>;
+        /**
+         * Цвет подписи; `{ from }` — «как у такого-то слоя» (см. `ColorFrom`).
+         *
+         * Ссылка тут нужна ровно затем же, зачем обводке моста: тем два десятка, и слой, отколотый от
+         * существующего (мелкие населённые пункты от крупных), в каждой из них пришлось бы красить
+         * заново. Своего хекса у такого слоя нет — у него есть «как у родителя», и ссылка это и говорит.
+         * Берётся ОДНОИМЁННОЕ свойство: `haloColor: { from: 'place-label' }` — это обводка того слоя.
+         */
+        color: Interpolated<string> | ColorFrom;
+        haloColor?: Interpolated<string> | ColorFrom;
         /** Толщина обводки в CSS-пикселях. Обводка обязательна поверх пёстрой карты. */
         haloWidth?: Interpolated<number>;
         /**
@@ -2358,6 +2387,17 @@ interface Candidate {
     /** Точка объекта в нормализованном меркаторе — по ней подпись и опознаётся. */
     mercX: number;
     mercY: number;
+    /**
+     * Ключ подписи, устойчивый между кадрами (см. `keyOf`).
+     *
+     * Считается ОДИН раз при сборе, а не там, где понадобился. Понадобился он трижды — при
+     * сортировке, при раскладке и при запоминании стороны, — а строится из двух `toFixed(9)`.
+     * В сортировке это било особенно больно: компаратор зовётся порядка `n log n` раз, и на полутора
+     * тысячах кандидатов построение ключей занимало 3.8 мс из 9.8 мс кадра.
+     */
+    key: string;
+    /** Прозрачность от расстояния до камеры: подпись растворяется в дымке вместе с землёй под ней. */
+    depth: number;
     /**
      * Линия объекта в ЭКРАННЫХ координатах — для подписи вдоль дороги.
      *
@@ -2446,12 +2486,21 @@ declare class SymbolRenderer {
     /**
      * Ключ подписи, устойчивый между кадрами.
      *
-     * Экранные координаты не годятся — они меняются от любого движения камеры;
-     * мировые пиксели тоже, они зависят от зума. Берём меркатор с точностью до
-     * сантиметра плюс слой: на одной точке может стоять и значок, и номер дома.
+     * Экранные координаты не годятся — они меняются от любого движения камеры; мировые пиксели тоже,
+     * они зависят от зума. Берём слой, текст и меркатор.
+     *
+     * ТОЧНОСТЬ КООРДИНАТЫ ГРУБАЯ НАМЕРЕННО — 1e-6 это метров сорок. Один и тот же объект приезжает в
+     * НЕСКОЛЬКИХ тайлах сразу (у тайлов буфер), и при движении карты рядом живут тайлы соседних
+     * зумов. Координата в тайле целая, а цена деления у z13 и z14 разная — тот же POI получается на
+     * метр в стороне. С точностью до сантиметра это был РАЗНЫЙ ключ: подпись теряла и липкость, и
+     * свой возраст, и проявлялась заново — то самое мигание на ровном месте.
+     *
+     * Разные объекты грубая сетка не путает, потому что в ключе есть текст: совпасть должны и слой, и
+     * название, и место с точностью до сорока метров.
      */
     static keyOf(s: {
         layerId: string;
+        text: string;
         mercX: number;
         mercY: number;
     }): string;
@@ -2476,6 +2525,67 @@ declare class SymbolRenderer {
     private stickyKeys;
     /** Время текущего кадра: одно на весь проход, иначе соседние буквы строки проявятся вразнобой. */
     private now;
+    /**
+     * ГДЕ УЖЕ СТОИТ ЭТО ЖЕ НАЗВАНИЕ — по одной записи на текст, на кадр.
+     *
+     * Шаг повторения (`symbolSpacing`) работает внутри ОДНОГО объекта: раскладка отступает от своей
+     * прошлой подписи и ищет следующее место. Но улица приезжает из тайлов десятком отдельных
+     * объектов, и каждый считает себя первым — на экране получается три «просп. Рудаки» подряд,
+     * сколько шаг ни увеличивай. У Baidu улица подписана один раз на экран, и добивается этого тот же
+     * шаг, только считанный по НАЗВАНИЮ, а не по объекту.
+     *
+     * Держим плоским списком координат: подписей вдоль линий в кадре десятки, и своя пара чисел на
+     * каждую дешевле объекта.
+     */
+    private lineAnchors;
+    /** Сторона, на которой подпись стояла в прошлом кадре: её и пробуем первой (см. `preferSide`). */
+    private lastSide;
+    /** То же для подписи вдоль дороги: где она стояла на самой линии (см. `keepAt`). */
+    private lineAt;
+    private lineAtNow;
+    /** Сколько чисел на одно запомненное место: меркатор x и y. */
+    private static readonly LINE_MARK;
+    /** Стороны ЭТОГО кадра — заменяют прошлые, когда раскладка закончена. */
+    private sideNow;
+    /** Дымка этого кадра и камера — по ним считается затухание подписи вдаль. */
+    private fog;
+    private tr;
+    /**
+     * ГДЕ ПОДПИСЬ СТОЯЛА — переведённое в расстояние вдоль СЕГОДНЯШНЕЙ линии.
+     *
+     * Место запоминается точкой на земле, а не расстоянием от начала линии. Расстояние не годится:
+     * при наклоне камера срезает у ломаной начало (точку за собой спроецировать нельзя), и с каждым
+     * сдвигом карты отсчёт ведётся от другой вершины — сетка мест уезжает вдоль улицы, а с ней и
+     * название. Точка на асфальте не зависит ни от камеры, ни от обрезки: её достаточно спроецировать
+     * заново и померить, на каком она расстоянии сейчас.
+     */
+    private rememberedAt;
+    /**
+     * Запомнить места этого кадра точками на земле.
+     *
+     * ДОПИСЫВАЕМ, А НЕ ЗАМЕНЯЕМ. Улица приезжает несколькими кусками — по куску на тайл, — и каждый
+     * ставит свою подпись. Ключ у них общий, поэтому запись последнего затирала бы места всех
+     * предыдущих: на следующем кадре они оказывались без памяти и выбирали место заново. Это и было
+     * остаточное «ползание» на части улиц.
+     */
+    private rememberAt;
+    /**
+     * Попадает ли бокс в область раскладки — кадр, расширенный на `LAYOUT_MARGIN`.
+     *
+     * Проверка на ПЕРЕСЕЧЕНИЕ, а не на вложенность: подпись, наполовину уехавшая за край, остаётся
+     * на своём месте и держит место в сетке коллизий — иначе её исчезновение переставляло бы соседей
+     * в середине кадра.
+     */
+    private withinLayout;
+    /**
+     * Затухание подписи, стоящей В ТОЧКЕ ЭКРАНА.
+     *
+     * Для подписи вдоль дороги другого способа нет: якорь у неё один на всю улицу, а буквы
+     * раскладываются по видимому куску, и от начала к концу строки расстояние до камеры меняется в
+     * разы. Считается по месту раскладки, то есть несколько раз на улицу, — обратная проекция стоит
+     * одного умножения на матрицу.
+     */
+    private depthFadeAt;
     /**
      * Когда подпись впервые встала — по этому времени считается её прозрачность.
      *
@@ -2520,6 +2630,19 @@ declare class SymbolRenderer {
      */
     /** Позиция слоя в стиле — по ней сортируется отрисовка. */
     private styleOrder;
+    /** Слои этого кадра — по ним разрешается ссылка «цвет как у такого-то слоя». */
+    private layersById;
+    /**
+     * Цвет с учётом ССЫЛКИ НА ЧУЖОЙ СЛОЙ (`{ from }`, см. `ColorFrom`).
+     *
+     * Тема красит слои по именам, и слой, отколотый от существующего, в каждой из двух десятков тем
+     * пришлось бы красить заново — а он по смыслу и не имеет своего цвета, он «как родитель».
+     * Ссылка разрешается по СОБСТВЕННОМУ стилю кадра, то есть уже с наложенной темой, и ровно на один
+     * уровень: цепочки нам не нужны, а кольцо из них молча съело бы кадр.
+     *
+     * Берётся одноимённое свойство: `haloColor: { from: 'place-label' }` — обводка того слоя.
+     */
+    private colorOf;
     private inStyleOrder;
     private draw;
     private ensureBuffers;
@@ -4202,6 +4325,13 @@ declare class LayerRenderer {
     private drawSeamHighlight;
     /** Нарисовать сшитые дома. Каждый лежит в координатах своего тайла-хозяина. */
     private drawSeams;
+    /**
+     * Буферы сшитого дома на видеокарте. Заводятся по требованию и переживают кадр.
+     *
+     * Отдельным методом, потому что проходов два и первым идёт КАРТА ТЕНЕЙ: заводись буфер внутри
+     * цветного прохода, тень в первом же кадре рисовалась бы по пустому месту.
+     */
+    private seamBucket;
     /**
      * Освободить буферы ТОЛЬКО тех хозяев, чья геометрия пересобрана.
      *
@@ -4227,6 +4357,23 @@ declare class LayerRenderer {
      * при этом пересобираются, — но и стоит он немного: первый же тайл с этим слоем даёт ответ.
      */
     private flattened;
+    /**
+     * СКОЛЬКО ГЕОМЕТРИИ КАДР ОТПРАВЛЯЕТ В ВИДЕОПАМЯТЬ ЗА РАЗ.
+     *
+     * Тайл приезжает из воркера готовыми буферами, но в видеопамять они уезжают ЛЕНИВО — в тот кадр,
+     * когда слой впервые рисуют. А приезжают тайлы пачками: при панораме в кадр разом въезжает
+     * несколько новых, и у каждого десяток слоёв. Замер на панораме в центре Душанбе: кадр, в котором
+     * ушло 8.8 МБ, занял 75 мс, кадры по 3.9 МБ — по 28–30 мс. Это и есть рывки: карта едет ровно, а
+     * раз в полсекунды замирает.
+     *
+     * Полтора мегабайта — примерно дюжина миллисекунд по тому же замеру, и этого хватает на средний
+     * поток при панораме (46 МБ за 70 кадров, то есть 0.67 МБ на кадр). Остаток переносится на
+     * следующий кадр, который тут же и заказывается: на глаз тайл достраивается за пару кадров, а
+     * вместо провала в 75 мс остаётся ровный ход.
+     */
+    private static readonly UPLOAD_BUDGET;
+    private uploadLeft;
+    private uploadDeferred;
     private bucketFor;
     destroy(ctx: Context): void;
 }
@@ -4804,6 +4951,36 @@ interface LinePlacementOptions {
      * 1 — считать прямо в экранных пикселях.
      */
     stableScale?: number;
+    /**
+     * Сколько ЭТОТ кусок отстоит от начала всей линии, пиксели.
+     *
+     * Нужно, чтобы места подписей были привязаны к самой дороге, а не к окну экрана. Кусок приходит
+     * обрезанным по кадру, и его начало едет вдоль улицы при каждом сдвиге карты. Раскладка, считающая
+     * от начала куска, поэтому оставляет подпись стоять НА ЭКРАНЕ, а дорога уезжает под ней: на глаз
+     * незаметно, зато подпись по очереди накрывает разные POI, и те мигают.
+     *
+     * Со смещением места считаются по общей для всей линии сетке шага, и подпись едет вместе с картой,
+     * как всё остальное.
+     */
+    offset?: number;
+    /**
+     * Где подпись стояла в ПРОШЛОМ кадре — расстояния от начала всей линии, пиксели.
+     *
+     * Эти места пробуются первыми. Без них раскладка каждый кадр выбирает заново, и подпись улицы
+     * кочует по дороге вслед за тем, какое место освободилось, — на экране это читается как дёрганье
+     * и мигание. У точечной подписи такого нет: у неё место одно, и оно от кадра не зависит.
+     */
+    keepAt?: readonly number[];
+    /**
+     * ГОТОВЫЙ СПИСОК МЕСТ — расстояния от начала линии, пиксели.
+     *
+     * Когда он задан, раскладка не ищет место сама: пробует эти и только эти, по порядку. Список
+     * считает вызывающий по САМОЙ дороге, поэтому места не зависят от того, где линию обрезал край
+     * кадра, — а значит подпись стоит на одном и том же куске асфальта и едет вместе с картой.
+     *
+     * Так подпись улицы становится похожа на точечную: у той место одно и от кадра не зависит.
+     */
+    atList?: readonly number[];
 }
 /**
  * Раскладывает подпись вдоль ломаной — возможно, НЕСКОЛЬКО раз.
@@ -5551,8 +5728,10 @@ interface PolygonPiece {
  *
  * Возвращает кольца с дырами. `null` — собрать не удалось, и звать надо прежний путь «каждый кусок
  * сам по себе»: так бывает, когда дом тянется дальше загруженных тайлов и куска посередине нет.
+ *
+ * `minWidth` — тоньше какой фигуры считать её мусором, в единицах тайла. Ноль отключает проверку.
  */
-declare function stitchPieces(pieces: PolygonPiece[]): Shape[] | null;
+declare function stitchPieces(pieces: PolygonPiece[], minWidth?: number): Shape[] | null;
 
 /**
  * Цель рендера с одной только глубиной — карта теней.

package/dist/osmgl.d.ts

@@ -1069,6 +1069,17 @@ interface FillExtrusionLayerSpec extends LayerBase {
          * контрастом на фасаде, и дом читается сеткой линий, а не объёмом.
          */
         seamStrength?: Interpolated<number>;
+        /**
+         * ЛЁД, 0..1. Ноль — обычный матовый дом.
+         *
+         * Настоящий лёд выдают две вещи, и обе видно на 3D-домах Baidu: кромка светится тем сильнее,
+         * чем острее угол взгляда к грани (у стекла и льда так отражается небо), и низ стены светлее
+         * верха — свет уходит в толщу и рассеивается. Ни то, ни другое не задать цветом: это зависит
+         * от камеры и от высоты точки, то есть считается в шейдере.
+         *
+         * Цвет при этом остаётся за темой: ручка только добавляет блик и градиент поверх него.
+         */
+        ice?: Interpolated<number>;
         /**
          * Доля светящихся окон, 0..1 — для ночных тем. Какие именно окна горят,
          * решает хеш ячейки, поэтому при движении камеры свет не «бегает».
@@ -1141,10 +1152,15 @@ interface SymbolLayerSpec extends LayerBase {
         iconTextGap?: number;
         /**
          * Где стоит иконка относительно подписи: `top` — над ней по центру (так у
-         * Mapbox Standard и у Яндекса: значок ровно над точкой объекта), `left` —
-         * сбоку, плотнее по вертикали.
+         * Mapbox Standard и у Яндекса: значок ровно над точкой объекта), `left` и
+         * `right` — сбоку, плотнее по вертикали, `behind` — плашка под подписью.
+         *
+         * `auto` — ПЕРЕБОР сторон: подпись справа от значка, занято — слева, занято — под ним. Так
+         * подписей на плотной карте помещается заметно больше: подпись, которой не нашлось места с
+         * одной стороны, находит его с другой вместо того, чтобы пропасть. Работает только с
+         * `iconFrame: 'pin'` — значок при этом остаётся остриём на объекте.
          */
-        iconPlacement?: 'top' | 'left' | 'behind';
+        iconPlacement?: 'top' | 'left' | 'right' | 'behind' | 'auto';
         /**
          * Как ставится подпись: `point` — горизонтально у точки привязки (по
          * умолчанию), `line` — вдоль линии объекта, изгибаясь по ней.
@@ -1186,8 +1202,13 @@ interface SymbolLayerSpec extends LayerBase {
          * Это ОТДЕЛЬНЫЙ значок под иконкой, а не обводка: обводка у нас общая с
          * текстом (одна программа), и «жирный контур» вокруг пиктограммы выглядит
          * грязно, а кружок — фигура со своей заливкой и своей рамкой.
+         *
+         * `pin` — та же подложка, но с остриём вниз. Отличие не в рисунке, а в ТОЧКЕ ПРИВЯЗКИ: у
+         * кружка на объекте стоит его середина, у булавки — остриё. Поэтому с булавкой подпись можно
+         * увести вбок (`iconPlacement: 'left'`), не теряя, к чему она относится: показывает не значок
+         * целиком, а его кончик. Так устроены POI у Baidu Maps.
          */
-        iconFrame?: 'circle' | 'none';
+        iconFrame?: 'circle' | 'pin' | 'none';
         /** Диаметр подложки относительно значка. */
         iconFrameScale?: number;
         /**
@@ -1253,8 +1274,16 @@ interface SymbolLayerSpec extends LayerBase {
         arrowGap?: Interpolated<number>;
     };
     paint: {
-        color: Interpolated<string>;
-        haloColor?: Interpolated<string>;
+        /**
+         * Цвет подписи; `{ from }` — «как у такого-то слоя» (см. `ColorFrom`).
+         *
+         * Ссылка тут нужна ровно затем же, зачем обводке моста: тем два десятка, и слой, отколотый от
+         * существующего (мелкие населённые пункты от крупных), в каждой из них пришлось бы красить
+         * заново. Своего хекса у такого слоя нет — у него есть «как у родителя», и ссылка это и говорит.
+         * Берётся ОДНОИМЁННОЕ свойство: `haloColor: { from: 'place-label' }` — это обводка того слоя.
+         */
+        color: Interpolated<string> | ColorFrom;
+        haloColor?: Interpolated<string> | ColorFrom;
         /** Толщина обводки в CSS-пикселях. Обводка обязательна поверх пёстрой карты. */
         haloWidth?: Interpolated<number>;
         /**
@@ -2358,6 +2387,17 @@ interface Candidate {
     /** Точка объекта в нормализованном меркаторе — по ней подпись и опознаётся. */
     mercX: number;
     mercY: number;
+    /**
+     * Ключ подписи, устойчивый между кадрами (см. `keyOf`).
+     *
+     * Считается ОДИН раз при сборе, а не там, где понадобился. Понадобился он трижды — при
+     * сортировке, при раскладке и при запоминании стороны, — а строится из двух `toFixed(9)`.
+     * В сортировке это било особенно больно: компаратор зовётся порядка `n log n` раз, и на полутора
+     * тысячах кандидатов построение ключей занимало 3.8 мс из 9.8 мс кадра.
+     */
+    key: string;
+    /** Прозрачность от расстояния до камеры: подпись растворяется в дымке вместе с землёй под ней. */
+    depth: number;
     /**
      * Линия объекта в ЭКРАННЫХ координатах — для подписи вдоль дороги.
      *
@@ -2446,12 +2486,21 @@ declare class SymbolRenderer {
     /**
      * Ключ подписи, устойчивый между кадрами.
      *
-     * Экранные координаты не годятся — они меняются от любого движения камеры;
-     * мировые пиксели тоже, они зависят от зума. Берём меркатор с точностью до
-     * сантиметра плюс слой: на одной точке может стоять и значок, и номер дома.
+     * Экранные координаты не годятся — они меняются от любого движения камеры; мировые пиксели тоже,
+     * они зависят от зума. Берём слой, текст и меркатор.
+     *
+     * ТОЧНОСТЬ КООРДИНАТЫ ГРУБАЯ НАМЕРЕННО — 1e-6 это метров сорок. Один и тот же объект приезжает в
+     * НЕСКОЛЬКИХ тайлах сразу (у тайлов буфер), и при движении карты рядом живут тайлы соседних
+     * зумов. Координата в тайле целая, а цена деления у z13 и z14 разная — тот же POI получается на
+     * метр в стороне. С точностью до сантиметра это был РАЗНЫЙ ключ: подпись теряла и липкость, и
+     * свой возраст, и проявлялась заново — то самое мигание на ровном месте.
+     *
+     * Разные объекты грубая сетка не путает, потому что в ключе есть текст: совпасть должны и слой, и
+     * название, и место с точностью до сорока метров.
      */
     static keyOf(s: {
         layerId: string;
+        text: string;
         mercX: number;
         mercY: number;
     }): string;
@@ -2476,6 +2525,67 @@ declare class SymbolRenderer {
     private stickyKeys;
     /** Время текущего кадра: одно на весь проход, иначе соседние буквы строки проявятся вразнобой. */
     private now;
+    /**
+     * ГДЕ УЖЕ СТОИТ ЭТО ЖЕ НАЗВАНИЕ — по одной записи на текст, на кадр.
+     *
+     * Шаг повторения (`symbolSpacing`) работает внутри ОДНОГО объекта: раскладка отступает от своей
+     * прошлой подписи и ищет следующее место. Но улица приезжает из тайлов десятком отдельных
+     * объектов, и каждый считает себя первым — на экране получается три «просп. Рудаки» подряд,
+     * сколько шаг ни увеличивай. У Baidu улица подписана один раз на экран, и добивается этого тот же
+     * шаг, только считанный по НАЗВАНИЮ, а не по объекту.
+     *
+     * Держим плоским списком координат: подписей вдоль линий в кадре десятки, и своя пара чисел на
+     * каждую дешевле объекта.
+     */
+    private lineAnchors;
+    /** Сторона, на которой подпись стояла в прошлом кадре: её и пробуем первой (см. `preferSide`). */
+    private lastSide;
+    /** То же для подписи вдоль дороги: где она стояла на самой линии (см. `keepAt`). */
+    private lineAt;
+    private lineAtNow;
+    /** Сколько чисел на одно запомненное место: меркатор x и y. */
+    private static readonly LINE_MARK;
+    /** Стороны ЭТОГО кадра — заменяют прошлые, когда раскладка закончена. */
+    private sideNow;
+    /** Дымка этого кадра и камера — по ним считается затухание подписи вдаль. */
+    private fog;
+    private tr;
+    /**
+     * ГДЕ ПОДПИСЬ СТОЯЛА — переведённое в расстояние вдоль СЕГОДНЯШНЕЙ линии.
+     *
+     * Место запоминается точкой на земле, а не расстоянием от начала линии. Расстояние не годится:
+     * при наклоне камера срезает у ломаной начало (точку за собой спроецировать нельзя), и с каждым
+     * сдвигом карты отсчёт ведётся от другой вершины — сетка мест уезжает вдоль улицы, а с ней и
+     * название. Точка на асфальте не зависит ни от камеры, ни от обрезки: её достаточно спроецировать
+     * заново и померить, на каком она расстоянии сейчас.
+     */
+    private rememberedAt;
+    /**
+     * Запомнить места этого кадра точками на земле.
+     *
+     * ДОПИСЫВАЕМ, А НЕ ЗАМЕНЯЕМ. Улица приезжает несколькими кусками — по куску на тайл, — и каждый
+     * ставит свою подпись. Ключ у них общий, поэтому запись последнего затирала бы места всех
+     * предыдущих: на следующем кадре они оказывались без памяти и выбирали место заново. Это и было
+     * остаточное «ползание» на части улиц.
+     */
+    private rememberAt;
+    /**
+     * Попадает ли бокс в область раскладки — кадр, расширенный на `LAYOUT_MARGIN`.
+     *
+     * Проверка на ПЕРЕСЕЧЕНИЕ, а не на вложенность: подпись, наполовину уехавшая за край, остаётся
+     * на своём месте и держит место в сетке коллизий — иначе её исчезновение переставляло бы соседей
+     * в середине кадра.
+     */
+    private withinLayout;
+    /**
+     * Затухание подписи, стоящей В ТОЧКЕ ЭКРАНА.
+     *
+     * Для подписи вдоль дороги другого способа нет: якорь у неё один на всю улицу, а буквы
+     * раскладываются по видимому куску, и от начала к концу строки расстояние до камеры меняется в
+     * разы. Считается по месту раскладки, то есть несколько раз на улицу, — обратная проекция стоит
+     * одного умножения на матрицу.
+     */
+    private depthFadeAt;
     /**
      * Когда подпись впервые встала — по этому времени считается её прозрачность.
      *
@@ -2520,6 +2630,19 @@ declare class SymbolRenderer {
      */
     /** Позиция слоя в стиле — по ней сортируется отрисовка. */
     private styleOrder;
+    /** Слои этого кадра — по ним разрешается ссылка «цвет как у такого-то слоя». */
+    private layersById;
+    /**
+     * Цвет с учётом ССЫЛКИ НА ЧУЖОЙ СЛОЙ (`{ from }`, см. `ColorFrom`).
+     *
+     * Тема красит слои по именам, и слой, отколотый от существующего, в каждой из двух десятков тем
+     * пришлось бы красить заново — а он по смыслу и не имеет своего цвета, он «как родитель».
+     * Ссылка разрешается по СОБСТВЕННОМУ стилю кадра, то есть уже с наложенной темой, и ровно на один
+     * уровень: цепочки нам не нужны, а кольцо из них молча съело бы кадр.
+     *
+     * Берётся одноимённое свойство: `haloColor: { from: 'place-label' }` — обводка того слоя.
+     */
+    private colorOf;
     private inStyleOrder;
     private draw;
     private ensureBuffers;
@@ -4202,6 +4325,13 @@ declare class LayerRenderer {
     private drawSeamHighlight;
     /** Нарисовать сшитые дома. Каждый лежит в координатах своего тайла-хозяина. */
     private drawSeams;
+    /**
+     * Буферы сшитого дома на видеокарте. Заводятся по требованию и переживают кадр.
+     *
+     * Отдельным методом, потому что проходов два и первым идёт КАРТА ТЕНЕЙ: заводись буфер внутри
+     * цветного прохода, тень в первом же кадре рисовалась бы по пустому месту.
+     */
+    private seamBucket;
     /**
      * Освободить буферы ТОЛЬКО тех хозяев, чья геометрия пересобрана.
      *
@@ -4227,6 +4357,23 @@ declare class LayerRenderer {
      * при этом пересобираются, — но и стоит он немного: первый же тайл с этим слоем даёт ответ.
      */
     private flattened;
+    /**
+     * СКОЛЬКО ГЕОМЕТРИИ КАДР ОТПРАВЛЯЕТ В ВИДЕОПАМЯТЬ ЗА РАЗ.
+     *
+     * Тайл приезжает из воркера готовыми буферами, но в видеопамять они уезжают ЛЕНИВО — в тот кадр,
+     * когда слой впервые рисуют. А приезжают тайлы пачками: при панораме в кадр разом въезжает
+     * несколько новых, и у каждого десяток слоёв. Замер на панораме в центре Душанбе: кадр, в котором
+     * ушло 8.8 МБ, занял 75 мс, кадры по 3.9 МБ — по 28–30 мс. Это и есть рывки: карта едет ровно, а
+     * раз в полсекунды замирает.
+     *
+     * Полтора мегабайта — примерно дюжина миллисекунд по тому же замеру, и этого хватает на средний
+     * поток при панораме (46 МБ за 70 кадров, то есть 0.67 МБ на кадр). Остаток переносится на
+     * следующий кадр, который тут же и заказывается: на глаз тайл достраивается за пару кадров, а
+     * вместо провала в 75 мс остаётся ровный ход.
+     */
+    private static readonly UPLOAD_BUDGET;
+    private uploadLeft;
+    private uploadDeferred;
     private bucketFor;
     destroy(ctx: Context): void;
 }
@@ -4804,6 +4951,36 @@ interface LinePlacementOptions {
      * 1 — считать прямо в экранных пикселях.
      */
     stableScale?: number;
+    /**
+     * Сколько ЭТОТ кусок отстоит от начала всей линии, пиксели.
+     *
+     * Нужно, чтобы места подписей были привязаны к самой дороге, а не к окну экрана. Кусок приходит
+     * обрезанным по кадру, и его начало едет вдоль улицы при каждом сдвиге карты. Раскладка, считающая
+     * от начала куска, поэтому оставляет подпись стоять НА ЭКРАНЕ, а дорога уезжает под ней: на глаз
+     * незаметно, зато подпись по очереди накрывает разные POI, и те мигают.
+     *
+     * Со смещением места считаются по общей для всей линии сетке шага, и подпись едет вместе с картой,
+     * как всё остальное.
+     */
+    offset?: number;
+    /**
+     * Где подпись стояла в ПРОШЛОМ кадре — расстояния от начала всей линии, пиксели.
+     *
+     * Эти места пробуются первыми. Без них раскладка каждый кадр выбирает заново, и подпись улицы
+     * кочует по дороге вслед за тем, какое место освободилось, — на экране это читается как дёрганье
+     * и мигание. У точечной подписи такого нет: у неё место одно, и оно от кадра не зависит.
+     */
+    keepAt?: readonly number[];
+    /**
+     * ГОТОВЫЙ СПИСОК МЕСТ — расстояния от начала линии, пиксели.
+     *
+     * Когда он задан, раскладка не ищет место сама: пробует эти и только эти, по порядку. Список
+     * считает вызывающий по САМОЙ дороге, поэтому места не зависят от того, где линию обрезал край
+     * кадра, — а значит подпись стоит на одном и том же куске асфальта и едет вместе с картой.
+     *
+     * Так подпись улицы становится похожа на точечную: у той место одно и от кадра не зависит.
+     */
+    atList?: readonly number[];
 }
 /**
  * Раскладывает подпись вдоль ломаной — возможно, НЕСКОЛЬКО раз.
@@ -5551,8 +5728,10 @@ interface PolygonPiece {
  *
  * Возвращает кольца с дырами. `null` — собрать не удалось, и звать надо прежний путь «каждый кусок
  * сам по себе»: так бывает, когда дом тянется дальше загруженных тайлов и куска посередине нет.
+ *
+ * `minWidth` — тоньше какой фигуры считать её мусором, в единицах тайла. Ноль отключает проверку.
  */
-declare function stitchPieces(pieces: PolygonPiece[]): Shape[] | null;
+declare function stitchPieces(pieces: PolygonPiece[], minWidth?: number): Shape[] | null;
 
 /**
  * Цель рендера с одной только глубиной — карта теней.