osmgl 0.9.0 → 0.9.2

package/dist/osmgl.d.cts

@@ -1367,16 +1367,27 @@ interface ModelLayerSpec {
         /** Прятать здание, которое модель заменяет (`replaces` + `anchor: replace`). */
         maskReplaced?: boolean;
         /**
-         * Показывать модели СРАЗУ во всей подробности, с самого нижнего зума.
+         * Полная геометрия (lod0) с самого нижнего зума, без упрощённой ступени.
          *
-         * По умолчанию у порога показа объект получает упрощённую геометрию (lod1) и четверть бюджета:
-         * на общем плане он занимает считанные пиксели, и подробность там не видна, а трафик и кадр
-         * стоит. Флаг отменяет обе поблажки — полный lod0 и полный бюджет на любом зуме.
+         * По умолчанию у порога показа объект получает lod1 и «дорисовывается» до lod0 только через
+         * два зума. На общем плане это незаметно, но если карта показывает объект как достопримечательность,
+         * читается браком: сначала огрублённый силуэт, потом подмена.
          *
-         * Включать с открытыми глазами: модели дают около 84 % треугольников кадра, и на широком
-         * экране полный набор с нижнего зума — это и загрузка, и память.
+         * Число объектов флаг НЕ трогает — за него отвечает `fullBudget`. Разделены они не для порядка:
+         * замер на боевой карте (Душанбе, z15.2, окно 1551×1346, наклон 55°) показал, что кадр сажает
+         * именно количество, а не подробность — со снятыми обеими поблажками медиана кадра при панораме
+         * была 30–38 мс против 17 мс на z17.8.
          */
         fullDetail?: boolean;
+        /**
+         * Полный бюджет моделей с нижнего зума.
+         *
+         * По умолчанию на пороге показа берётся четверть бюджета, и дальше он плавно растёт до полного
+         * за три зума: на общем плане объект занимает считанные пиксели, и сотня таких объектов стоит
+         * кадра и трафика, ничего не добавляя глазу. Включать на широком экране с осторожностью —
+         * модели дают около 84 % треугольников кадра.
+         */
+        fullBudget?: boolean;
     };
 }
 type StyleLayerSpec = FillLayerSpec | LineLayerSpec | FillExtrusionLayerSpec | SurfaceLayerSpec | SymbolLayerSpec | RasterLayerSpec;
@@ -3896,6 +3907,27 @@ declare class LayerRenderer {
     /** Разобранные поверхности без заменённых фигур. Сбрасывается вместе с `hiddenCut`. */
     private surfaceCut;
     private bucketIds;
+    /**
+     * Собрать дома, разрезанные границей тайла. Зовётся В НАЧАЛЕ КАДРА — и это принципиально.
+     *
+     * Сборка стояла внутри прохода зданий, а раскладка «что прятать в каком тайле»
+     * (`syncHiddenStamp`) считается раньше. В одном и том же кадре резка шла, значит, по ПРОШЛОЙ
+     * сборке. Пока состав кусков не менялся, разницы не было, но при движении карты тайлы приезжают
+     * и вытесняются постоянно, и кадр получал одно из двух:
+     *
+     *  · дом перестал собираться — куски по прошлой раскладке ещё спрятаны, а замены уже нет: на
+     *    месте дома ДЫРА, обрезанная ровно по границам тайлов;
+     *  · дом начал собираться — замена нарисована, а куски по прошлой раскладке ещё не спрятаны:
+     *    две геометрии в одном месте.
+     *
+     * И то и другое живёт один кадр, поэтому и выглядело как «иногда при движении». Теперь сборка и
+     * раскладка считаются в одном порядке, и кадр видит согласованное состояние.
+     *
+     * Слой берём ПЕРВЫЙ подходящий: сборщик один на карту, ключ бакета у него один. Второй объёмный
+     * слой на базовом источнике сборку бы перетирал — но такого в наших стилях нет, а появится —
+     * сломается заметно, а не тихо.
+     */
+    private syncSeams;
     /**
      * Что заменено 3D-моделями. Для заливок и линий — единственный набор, который к ним применим.
      *

package/dist/osmgl.d.ts

@@ -1367,16 +1367,27 @@ interface ModelLayerSpec {
         /** Прятать здание, которое модель заменяет (`replaces` + `anchor: replace`). */
         maskReplaced?: boolean;
         /**
-         * Показывать модели СРАЗУ во всей подробности, с самого нижнего зума.
+         * Полная геометрия (lod0) с самого нижнего зума, без упрощённой ступени.
          *
-         * По умолчанию у порога показа объект получает упрощённую геометрию (lod1) и четверть бюджета:
-         * на общем плане он занимает считанные пиксели, и подробность там не видна, а трафик и кадр
-         * стоит. Флаг отменяет обе поблажки — полный lod0 и полный бюджет на любом зуме.
+         * По умолчанию у порога показа объект получает lod1 и «дорисовывается» до lod0 только через
+         * два зума. На общем плане это незаметно, но если карта показывает объект как достопримечательность,
+         * читается браком: сначала огрублённый силуэт, потом подмена.
          *
-         * Включать с открытыми глазами: модели дают около 84 % треугольников кадра, и на широком
-         * экране полный набор с нижнего зума — это и загрузка, и память.
+         * Число объектов флаг НЕ трогает — за него отвечает `fullBudget`. Разделены они не для порядка:
+         * замер на боевой карте (Душанбе, z15.2, окно 1551×1346, наклон 55°) показал, что кадр сажает
+         * именно количество, а не подробность — со снятыми обеими поблажками медиана кадра при панораме
+         * была 30–38 мс против 17 мс на z17.8.
          */
         fullDetail?: boolean;
+        /**
+         * Полный бюджет моделей с нижнего зума.
+         *
+         * По умолчанию на пороге показа берётся четверть бюджета, и дальше он плавно растёт до полного
+         * за три зума: на общем плане объект занимает считанные пиксели, и сотня таких объектов стоит
+         * кадра и трафика, ничего не добавляя глазу. Включать на широком экране с осторожностью —
+         * модели дают около 84 % треугольников кадра.
+         */
+        fullBudget?: boolean;
     };
 }
 type StyleLayerSpec = FillLayerSpec | LineLayerSpec | FillExtrusionLayerSpec | SurfaceLayerSpec | SymbolLayerSpec | RasterLayerSpec;
@@ -3896,6 +3907,27 @@ declare class LayerRenderer {
     /** Разобранные поверхности без заменённых фигур. Сбрасывается вместе с `hiddenCut`. */
     private surfaceCut;
     private bucketIds;
+    /**
+     * Собрать дома, разрезанные границей тайла. Зовётся В НАЧАЛЕ КАДРА — и это принципиально.
+     *
+     * Сборка стояла внутри прохода зданий, а раскладка «что прятать в каком тайле»
+     * (`syncHiddenStamp`) считается раньше. В одном и том же кадре резка шла, значит, по ПРОШЛОЙ
+     * сборке. Пока состав кусков не менялся, разницы не было, но при движении карты тайлы приезжают
+     * и вытесняются постоянно, и кадр получал одно из двух:
+     *
+     *  · дом перестал собираться — куски по прошлой раскладке ещё спрятаны, а замены уже нет: на
+     *    месте дома ДЫРА, обрезанная ровно по границам тайлов;
+     *  · дом начал собираться — замена нарисована, а куски по прошлой раскладке ещё не спрятаны:
+     *    две геометрии в одном месте.
+     *
+     * И то и другое живёт один кадр, поэтому и выглядело как «иногда при движении». Теперь сборка и
+     * раскладка считаются в одном порядке, и кадр видит согласованное состояние.
+     *
+     * Слой берём ПЕРВЫЙ подходящий: сборщик один на карту, ключ бакета у него один. Второй объёмный
+     * слой на базовом источнике сборку бы перетирал — но такого в наших стилях нет, а появится —
+     * сломается заметно, а не тихо.
+     */
+    private syncSeams;
     /**
      * Что заменено 3D-моделями. Для заливок и линий — единственный набор, который к ним применим.
      *