osmgl 0.4.0 → 0.5.0

package/dist/osmgl.d.cts

@@ -751,14 +751,19 @@ interface LayerBase {
      */
     splitBy?: string;
     /**
-     * Рисовать ПОВЕРХ объёма, без теста глубины.
+     * Накладка: слой рисуется вне общей очереди, без теста глубины. Значение говорит, ГДЕ.
      *
-     * Нужно планам этажей: они лежат внутри здания, и в обычном порядке их
-     * закрыла бы его крыша. План этажа и есть накладка — «мы внутри», — а
-     * покрывает он ровно контур своего здания, поэтому соседние дома остаются
+     * `'volume'` (и `true` — прежнее написание) — поверх объёма. Нужно планам этажей: они лежат
+     * внутри здания, и в обычном порядке их закрыла бы его крыша. План этажа и есть накладка —
+     * «мы внутри», — а покрывает он ровно контур своего здания, поэтому соседние дома остаются
      * видимыми.
+     *
+     * `'roads'` — сразу после дорог и ДО объёма. Это место разметки: зебры, перекрытия, всё, что
+     * лежит на асфальте. Дороги рисуются позже поверхностей, поэтому в общую очередь такая
+     * разметка не встаёт, но и поверх объёма ей делать нечего — зебра, висящая на стене дома,
+     * первой бросается в глаза.
      */
-    overlay?: boolean;
+    overlay?: boolean | 'roads' | 'volume';
     /** Выключить слой, не удаляя из стиля. */
     visible?: boolean;
     /**
@@ -979,6 +984,21 @@ interface FillExtrusionLayerSpec extends LayerBase {
         windowGlow?: Interpolated<number>;
         /** Высота этажа в метрах: шаг сетки окон. */
         floorHeight?: Interpolated<number>;
+        /**
+         * На сколько метров стекло утоплено от плоскости стены (по умолчанию 0.18).
+         * Край проёма кладёт на утопленное стекло тень со стороны, где нет солнца, —
+         * именно она и читается как глубина. Ноль возвращает плоское окно.
+         */
+        windowRecess?: Interpolated<number>;
+        /** Глубина тени откоса, 0..1. */
+        windowRecessShade?: Interpolated<number>;
+        /**
+         * Высота в метрах, на которой цокольное затемнение сходит на нет (по умолчанию 4).
+         * Затемнение считается для ВСЕЙ стены, включая скруглённые углы и фронтоны.
+         */
+        plinthHeight?: Interpolated<number>;
+        /** Сила цокольного затемнения у самой земли, 0..1. */
+        plinthShade?: Interpolated<number>;
         /**
          * Разброс цвета СКАТНЫХ кровель, 0..1. Тон берётся из хеша здания, яркость
          * остаётся от темы — иначе терракота всплыла бы посреди ночной карты.
@@ -3498,6 +3518,8 @@ declare class LayerRenderer {
      * перелёт через город.
      */
     private patternScale;
+    /** Камера в метрах от мирового нуля — считается раз на кадр (см. render). */
+    private cameraMeters;
     /**
      * Множитель процедурной детализации (фасады, материалы) — из профиля
      * качества. Ноль не ставим даже на слабых устройствах: без окон и ряби карта
@@ -3779,6 +3801,14 @@ declare class LayerRenderer {
      * И масштаб, И начало — тогда координата остаётся непрерывной, а размеры
      * прежними.
      */
+    /**
+     * Накладка — слои вне общей очереди, без теста глубины.
+     *
+     * Позиций две, и они не взаимозаменяемы. `roads` идёт до объёма: разметка лежит на асфальте, и
+     * дом обязан её закрывать. `volume` идёт после: план этажа лежит ВНУТРИ здания, и в обычном
+     * порядке его закрыла бы крыша.
+     */
+    private drawOverlay;
     private applyTileScale;
     private applyMaterial;
     private drawFill;

package/dist/osmgl.d.ts

@@ -751,14 +751,19 @@ interface LayerBase {
      */
     splitBy?: string;
     /**
-     * Рисовать ПОВЕРХ объёма, без теста глубины.
+     * Накладка: слой рисуется вне общей очереди, без теста глубины. Значение говорит, ГДЕ.
      *
-     * Нужно планам этажей: они лежат внутри здания, и в обычном порядке их
-     * закрыла бы его крыша. План этажа и есть накладка — «мы внутри», — а
-     * покрывает он ровно контур своего здания, поэтому соседние дома остаются
+     * `'volume'` (и `true` — прежнее написание) — поверх объёма. Нужно планам этажей: они лежат
+     * внутри здания, и в обычном порядке их закрыла бы его крыша. План этажа и есть накладка —
+     * «мы внутри», — а покрывает он ровно контур своего здания, поэтому соседние дома остаются
      * видимыми.
+     *
+     * `'roads'` — сразу после дорог и ДО объёма. Это место разметки: зебры, перекрытия, всё, что
+     * лежит на асфальте. Дороги рисуются позже поверхностей, поэтому в общую очередь такая
+     * разметка не встаёт, но и поверх объёма ей делать нечего — зебра, висящая на стене дома,
+     * первой бросается в глаза.
      */
-    overlay?: boolean;
+    overlay?: boolean | 'roads' | 'volume';
     /** Выключить слой, не удаляя из стиля. */
     visible?: boolean;
     /**
@@ -979,6 +984,21 @@ interface FillExtrusionLayerSpec extends LayerBase {
         windowGlow?: Interpolated<number>;
         /** Высота этажа в метрах: шаг сетки окон. */
         floorHeight?: Interpolated<number>;
+        /**
+         * На сколько метров стекло утоплено от плоскости стены (по умолчанию 0.18).
+         * Край проёма кладёт на утопленное стекло тень со стороны, где нет солнца, —
+         * именно она и читается как глубина. Ноль возвращает плоское окно.
+         */
+        windowRecess?: Interpolated<number>;
+        /** Глубина тени откоса, 0..1. */
+        windowRecessShade?: Interpolated<number>;
+        /**
+         * Высота в метрах, на которой цокольное затемнение сходит на нет (по умолчанию 4).
+         * Затемнение считается для ВСЕЙ стены, включая скруглённые углы и фронтоны.
+         */
+        plinthHeight?: Interpolated<number>;
+        /** Сила цокольного затемнения у самой земли, 0..1. */
+        plinthShade?: Interpolated<number>;
         /**
          * Разброс цвета СКАТНЫХ кровель, 0..1. Тон берётся из хеша здания, яркость
          * остаётся от темы — иначе терракота всплыла бы посреди ночной карты.
@@ -3498,6 +3518,8 @@ declare class LayerRenderer {
      * перелёт через город.
      */
     private patternScale;
+    /** Камера в метрах от мирового нуля — считается раз на кадр (см. render). */
+    private cameraMeters;
     /**
      * Множитель процедурной детализации (фасады, материалы) — из профиля
      * качества. Ноль не ставим даже на слабых устройствах: без окон и ряби карта
@@ -3779,6 +3801,14 @@ declare class LayerRenderer {
      * И масштаб, И начало — тогда координата остаётся непрерывной, а размеры
      * прежними.
      */
+    /**
+     * Накладка — слои вне общей очереди, без теста глубины.
+     *
+     * Позиций две, и они не взаимозаменяемы. `roads` идёт до объёма: разметка лежит на асфальте, и
+     * дом обязан её закрывать. `volume` идёт после: план этажа лежит ВНУТРИ здания, и в обычном
+     * порядке его закрыла бы крыша.
+     */
+    private drawOverlay;
     private applyTileScale;
     private applyMaterial;
     private drawFill;