osmgl 0.17.0 → 0.18.1

package/dist/osmgl.d.cts

@@ -2752,6 +2752,16 @@ declare class Style {
      * рендер просто берёт другой готовый бакет.
      */
     readonly splitValues: Record<string, string | number>;
+    /**
+     * НА СКОЛЬКО ПОДНИМАТЬ ЛИНИЮ ЗА УРОВЕНЬ ПЕРЕСЕЧЕНИЯ — только если есть полотно ИЗ ЛИНИЙ.
+     *
+     * Лента моста поднимается ради своего полотна (`fromLines`-поверхность): оно подняло геометрию
+     * на `levelHeight`, и лента на прежней высоте оказалась бы внутри него. Нет такого полотна — нет и
+     * причины поднимать ленту. А `levelHeight` у стиля бывает и без него: его ставит набор асфальта
+     * (`navigram/roadbed`) ради своих эстакад, и обычная линия моста висела в воздухе на 8 м там,
+     * где асфальта ещё нет (z15–16, 30.09.2026).
+     */
+    lineLevelHeight(): number;
     constructor(spec?: StyleSpec);
     get background(): RGBA;
     /**
@@ -3690,8 +3700,42 @@ declare class SymbolRenderer {
     private shownAt;
     /** Есть ли в кадре подпись, которая ещё проявляется — по ней решается, нужен ли следующий кадр. */
     private fading;
+    /**
+     * ГОТОВЫЙ КАДР ПОДПИСЕЙ — ПОВТОРЯЕМ, ЕСЛИ НИЧЕГО НЕ МЕНЯЛОСЬ (30.09.2026).
+     *
+     * Карта рисует кадры и в покое — ради бегущей воды. Раскладывать подписи заново на каждом таком
+     * кадре незачем: камера та же, тайлы те же, значит и ответ тот же, — а раскладка самая дорогая
+     * часть кадра после геометрии. Хуже того, раскладка зависит от прошлого кадра (липкость, сторона,
+     * место на линии), и любая её неустойчивость в покое превращается в подпись, которая без
+     * остановки прыгает туда-сюда. MapLibre и Mapbox поступают так же: раскладка — по изменению, а
+     * между ними рисуется уже готовое.
+     *
+     * Подпись кадра (`frameSignature`) собирает ВСЁ, от чего раскладка зависит: камеру, размер,
+     * поля, версии данных источников, видимость слоёв подписей, наведение, скрытие, выбранный дом и
+     * поколение картинок. Не хватило глифов или значков — кадр не запоминается: следующий обязан
+     * разложиться с ними. При рельефе повтор выключен: высоты доезжают плитками, а их версии здесь нет.
+     */
+    private lastSignature;
+    private lastRanges;
+    private styleIds;
+    private nextStyleId;
+    private idOf;
+    private frameSignature;
     /** Прозрачность подписи: только что появилась — проявляется, стоит давно — единица. */
     private fadeOf;
+    /**
+     * ★ ПРОЯВЛЕНИЕ ОТМЕЧАЕТ ТОЛЬКО ТО, ЧТО ВСТАЛО (30.09.2026).
+     *
+     * Прозрачность считается в начале `place`, ещё ДО проверки на столкновение, и флаг «кто-то
+     * проявляется» ставился и для кандидата, которому места не нашлось. Его запись о возрасте тут же
+     * стиралась (`rememberPlaced` держит только вставшие), на следующем кадре всё повторялось — флаг
+     * не гас никогда. Кандидатов в кадре сотни, встают десятки, поэтому карта В ПОКОЕ рисовала
+     * 60 кадров в секунду и раскладывала подписи заново каждый кадр (замер на проде: 2538 кадров
+     * подряд). Подпись вдоль дороги, чьё место зависит от прошлого кадра, на части ракурсов при этом
+     * бесконечно перескакивала между двумя местами. Теперь флаг ставит цикл раскладки — по вставшей
+     * подписи, которой ещё не исполнилось `FADE_MS`.
+     */
+    private stillFading;
     /**
      * Порядок разбора кандидатов: важнее — раньше, у прошедших первыми есть шанс занять место.
      *
@@ -3740,6 +3784,8 @@ declare class SymbolRenderer {
     private colorOf;
     private inStyleOrder;
     private draw;
+    /** Нарисовать диапазоны уже залитого буфера — и после раскладки, и при повторе кадра. */
+    private drawRanges;
     /** Запись подложки этого слоя в атласе — по ней градиент знает высоту фигуры. */
     private frameEntryOf;
     private ensureBuffers;
@@ -5407,6 +5453,17 @@ declare class LayerRenderer {
     private materialTime;
     /** Хоть один материал в кадре анимируется — значит нужен следующий кадр. */
     private materialAnimating;
+    /**
+     * Материал ТЕКУЩЕГО слоя анимирован (бегущая вода) — но кадр просим, только если слой что-то
+     * нарисовал.
+     *
+     * Раньше `applyMaterial` сразу ставил `materialAnimating`: слой воды включён на зуме — значит,
+     * следующий кадр, даже когда воды на экране нет вовсе. Слой воды есть почти во всех темах, и карта
+     * в покое рисовала 60 кадров в секунду на любом зуме (замер на проде 30.09.2026: 180 кадров за
+     * 3 с на районе без единого водоёма). Теперь флаг ставит цикл отрисовки — по тайлу, где нашлась
+     * геометрия.
+     */
+    private materialPending;
     /**
      * Номер тайла в трафарете — по нему поверхности обрезаются по своему тайлу.
      * Пусто, если трафарет в этом кадре не размечен (см. `drawTileStencil`).

package/dist/osmgl.d.ts

@@ -2752,6 +2752,16 @@ declare class Style {
      * рендер просто берёт другой готовый бакет.
      */
     readonly splitValues: Record<string, string | number>;
+    /**
+     * НА СКОЛЬКО ПОДНИМАТЬ ЛИНИЮ ЗА УРОВЕНЬ ПЕРЕСЕЧЕНИЯ — только если есть полотно ИЗ ЛИНИЙ.
+     *
+     * Лента моста поднимается ради своего полотна (`fromLines`-поверхность): оно подняло геометрию
+     * на `levelHeight`, и лента на прежней высоте оказалась бы внутри него. Нет такого полотна — нет и
+     * причины поднимать ленту. А `levelHeight` у стиля бывает и без него: его ставит набор асфальта
+     * (`navigram/roadbed`) ради своих эстакад, и обычная линия моста висела в воздухе на 8 м там,
+     * где асфальта ещё нет (z15–16, 30.09.2026).
+     */
+    lineLevelHeight(): number;
     constructor(spec?: StyleSpec);
     get background(): RGBA;
     /**
@@ -3690,8 +3700,42 @@ declare class SymbolRenderer {
     private shownAt;
     /** Есть ли в кадре подпись, которая ещё проявляется — по ней решается, нужен ли следующий кадр. */
     private fading;
+    /**
+     * ГОТОВЫЙ КАДР ПОДПИСЕЙ — ПОВТОРЯЕМ, ЕСЛИ НИЧЕГО НЕ МЕНЯЛОСЬ (30.09.2026).
+     *
+     * Карта рисует кадры и в покое — ради бегущей воды. Раскладывать подписи заново на каждом таком
+     * кадре незачем: камера та же, тайлы те же, значит и ответ тот же, — а раскладка самая дорогая
+     * часть кадра после геометрии. Хуже того, раскладка зависит от прошлого кадра (липкость, сторона,
+     * место на линии), и любая её неустойчивость в покое превращается в подпись, которая без
+     * остановки прыгает туда-сюда. MapLibre и Mapbox поступают так же: раскладка — по изменению, а
+     * между ними рисуется уже готовое.
+     *
+     * Подпись кадра (`frameSignature`) собирает ВСЁ, от чего раскладка зависит: камеру, размер,
+     * поля, версии данных источников, видимость слоёв подписей, наведение, скрытие, выбранный дом и
+     * поколение картинок. Не хватило глифов или значков — кадр не запоминается: следующий обязан
+     * разложиться с ними. При рельефе повтор выключен: высоты доезжают плитками, а их версии здесь нет.
+     */
+    private lastSignature;
+    private lastRanges;
+    private styleIds;
+    private nextStyleId;
+    private idOf;
+    private frameSignature;
     /** Прозрачность подписи: только что появилась — проявляется, стоит давно — единица. */
     private fadeOf;
+    /**
+     * ★ ПРОЯВЛЕНИЕ ОТМЕЧАЕТ ТОЛЬКО ТО, ЧТО ВСТАЛО (30.09.2026).
+     *
+     * Прозрачность считается в начале `place`, ещё ДО проверки на столкновение, и флаг «кто-то
+     * проявляется» ставился и для кандидата, которому места не нашлось. Его запись о возрасте тут же
+     * стиралась (`rememberPlaced` держит только вставшие), на следующем кадре всё повторялось — флаг
+     * не гас никогда. Кандидатов в кадре сотни, встают десятки, поэтому карта В ПОКОЕ рисовала
+     * 60 кадров в секунду и раскладывала подписи заново каждый кадр (замер на проде: 2538 кадров
+     * подряд). Подпись вдоль дороги, чьё место зависит от прошлого кадра, на части ракурсов при этом
+     * бесконечно перескакивала между двумя местами. Теперь флаг ставит цикл раскладки — по вставшей
+     * подписи, которой ещё не исполнилось `FADE_MS`.
+     */
+    private stillFading;
     /**
      * Порядок разбора кандидатов: важнее — раньше, у прошедших первыми есть шанс занять место.
      *
@@ -3740,6 +3784,8 @@ declare class SymbolRenderer {
     private colorOf;
     private inStyleOrder;
     private draw;
+    /** Нарисовать диапазоны уже залитого буфера — и после раскладки, и при повторе кадра. */
+    private drawRanges;
     /** Запись подложки этого слоя в атласе — по ней градиент знает высоту фигуры. */
     private frameEntryOf;
     private ensureBuffers;
@@ -5407,6 +5453,17 @@ declare class LayerRenderer {
     private materialTime;
     /** Хоть один материал в кадре анимируется — значит нужен следующий кадр. */
     private materialAnimating;
+    /**
+     * Материал ТЕКУЩЕГО слоя анимирован (бегущая вода) — но кадр просим, только если слой что-то
+     * нарисовал.
+     *
+     * Раньше `applyMaterial` сразу ставил `materialAnimating`: слой воды включён на зуме — значит,
+     * следующий кадр, даже когда воды на экране нет вовсе. Слой воды есть почти во всех темах, и карта
+     * в покое рисовала 60 кадров в секунду на любом зуме (замер на проде 30.09.2026: 180 кадров за
+     * 3 с на районе без единого водоёма). Теперь флаг ставит цикл отрисовки — по тайлу, где нашлась
+     * геометрия.
+     */
+    private materialPending;
     /**
      * Номер тайла в трафарете — по нему поверхности обрезаются по своему тайлу.
      * Пусто, если трафарет в этом кадре не размечен (см. `drawTileStencil`).