osmgl 0.11.0 → 0.12.1

package/dist/osmgl.d.cts

@@ -1550,6 +1550,18 @@ interface SymbolLayerSpec extends LayerBase {
          * текст и иконки). Нужен плашкам: щит номера трассы это светлая заливка с
          * рамкой, а номер на ней тёмный.
          */
+        /**
+         * НАСЫЩЕННОСТЬ ПОДПИСИ: добавка к толщине штриха в пикселях (0 — как в шрифте).
+         *
+         * Своего полужирного начертания у нас нет: глифы приходят одним набором с сервера шрифтов, и
+         * второй набор — это вторая загрузка и второй атлас на каждую карту. Зато буква хранится
+         * полем расстояний, а в нём «жирнее» — это просто сдвиг границы наружу: тот же контур,
+         * отпущенный на доли пикселя. Так набирают полужирный и в Mapbox, и в Яндексе.
+         *
+         * Мера — пиксели экрана, а не условная единица: на глаз подпись прибавляет ровно столько,
+         * и на любом кегле прибавка одна и та же.
+         */
+        textWeight?: Interpolated<number>;
         iconColor?: Interpolated<string>;
         iconHaloColor?: Interpolated<string>;
         iconHaloWidth?: Interpolated<number>;
@@ -1571,6 +1583,32 @@ interface SymbolLayerSpec extends LayerBase {
         /** Рамка подложки. По умолчанию — цвет значка, приглушённый до трети. */
         frameHaloColor?: Interpolated<string>;
         frameHaloWidth?: Interpolated<number>;
+        /**
+         * ГРАДИЕНТ ПО ПОДЛОЖКЕ: насколько верх кружка светлее, а низ темнее своего цвета (0..1,
+         * по умолчанию 0 — ровная заливка).
+         *
+         * Задан силой, а не парой цветов, нарочно. Цвет у подложки один на категорию — у еды свой,
+         * у транспорта свой, — и вторым цветом пришлось бы задавать их все заново, по два на каждую.
+         * Светлота же считается от того цвета, что уже есть, поэтому объём получают сразу все
+         * категории, и перекрашивание темы ничего не ломает.
+         */
+        frameGradient?: Interpolated<number>;
+        /**
+         * ТЕНЬ ПОД ПОДЛОЖКОЙ: непрозрачность, 0..1 (по умолчанию 0 — без тени).
+         *
+         * Кружок без тени лежит В карте, с тенью — НАД ней, и на пёстрой застройке это разница между
+         * «пятно среди домов» и «метка поверх города».
+         */
+        frameShadow?: Interpolated<number>;
+        /** Сдвиг тени вниз в пикселях экрана (по умолчанию 3). */
+        frameShadowOffset?: Interpolated<number>;
+        /** Размытие тени в пикселях экрана (по умолчанию 6). */
+        frameShadowBlur?: Interpolated<number>;
+        /**
+         * Свой цвет тени. По умолчанию — цвет подложки, притемнённый: серая тень под цветным значком
+         * читается грязью, а потемневший собственный цвет — глубиной.
+         */
+        frameShadowColor?: Interpolated<string>;
         /**
          * Цвета частей составного значка (`layout.iconParts`), по порядку частей.
          *
@@ -3467,6 +3505,8 @@ declare class SymbolRenderer {
     private colorOf;
     private inStyleOrder;
     private draw;
+    /** Запись подложки этого слоя в атласе — по ней градиент знает высоту фигуры. */
+    private frameEntryOf;
     private ensureBuffers;
     /** Догружает недостающие глифы и иконки и просит перерисовать кадр. */
     private requestMissing;
@@ -7279,6 +7319,15 @@ interface RoadGraphOptions {
      * Без него сглаживание на длинных звеньях и срезает много, и сглаживает мало — см. `densifyLine`.
      */
     densify?: number;
+    /**
+     * ДЛИНА САМОГО БОЛЬШОГО КОЛЬЦА, метры. 0 — кольца не собирать.
+     *
+     * По ней кольцевая развязка отличается от квартала: и то и другое — замкнутый обход по сети, но
+     * круг это десятки метров, а квартал — сотни. Порог задаётся снаружи, потому что снаружи задан
+     * и масштаб: у генератора тайлов метры меркаторские и на широте Душанбе длиннее наземных в 1.28
+     * раза.
+     */
+    ringMax?: number;
 }
 declare function buildRoadGraph(axes: RoadAxis[], options?: RoadGraphOptions): RoadGraph;
 
@@ -7402,6 +7451,17 @@ interface MarkingOptions {
      * разметка целиком лежит внутри его же полотна, и вырезалась бы вся.
      */
     keepOut?: (x: number, y: number, chain: RoadChain) => boolean;
+    /**
+     * ГДЕ НА ПОДХОДЕ СТОИТ ПЕШЕХОДНЫЙ ПЕРЕХОД — расстояние ОТ УЗЛА вдоль оси, в метрах.
+     *
+     * Сам движок ставит его по отступу узла: перекрёсток кончился — через метр с небольшим переход.
+     * Для одной проезжей части это верно, а для улицы из нескольких — нет: узлы у них на
+     * перекрёстке стоят вразнобой, и переходы выходят лесенкой. Кто знает про соседей — тот и
+     * скажет, где ряд; вернул `null` — считаем сами, как раньше.
+     *
+     * Стоп-линия отмеряется ОТ ПЕРЕХОДА, поэтому едет вместе с ним и остаётся к нему прижатой.
+     */
+    crossingAt?: (chain: RoadChain, index: number, node: number) => number | null;
 }
 declare function roadMarkings(graph: RoadGraph, options?: MarkingOptions): Marking[];
 

package/dist/osmgl.d.ts

@@ -1550,6 +1550,18 @@ interface SymbolLayerSpec extends LayerBase {
          * текст и иконки). Нужен плашкам: щит номера трассы это светлая заливка с
          * рамкой, а номер на ней тёмный.
          */
+        /**
+         * НАСЫЩЕННОСТЬ ПОДПИСИ: добавка к толщине штриха в пикселях (0 — как в шрифте).
+         *
+         * Своего полужирного начертания у нас нет: глифы приходят одним набором с сервера шрифтов, и
+         * второй набор — это вторая загрузка и второй атлас на каждую карту. Зато буква хранится
+         * полем расстояний, а в нём «жирнее» — это просто сдвиг границы наружу: тот же контур,
+         * отпущенный на доли пикселя. Так набирают полужирный и в Mapbox, и в Яндексе.
+         *
+         * Мера — пиксели экрана, а не условная единица: на глаз подпись прибавляет ровно столько,
+         * и на любом кегле прибавка одна и та же.
+         */
+        textWeight?: Interpolated<number>;
         iconColor?: Interpolated<string>;
         iconHaloColor?: Interpolated<string>;
         iconHaloWidth?: Interpolated<number>;
@@ -1571,6 +1583,32 @@ interface SymbolLayerSpec extends LayerBase {
         /** Рамка подложки. По умолчанию — цвет значка, приглушённый до трети. */
         frameHaloColor?: Interpolated<string>;
         frameHaloWidth?: Interpolated<number>;
+        /**
+         * ГРАДИЕНТ ПО ПОДЛОЖКЕ: насколько верх кружка светлее, а низ темнее своего цвета (0..1,
+         * по умолчанию 0 — ровная заливка).
+         *
+         * Задан силой, а не парой цветов, нарочно. Цвет у подложки один на категорию — у еды свой,
+         * у транспорта свой, — и вторым цветом пришлось бы задавать их все заново, по два на каждую.
+         * Светлота же считается от того цвета, что уже есть, поэтому объём получают сразу все
+         * категории, и перекрашивание темы ничего не ломает.
+         */
+        frameGradient?: Interpolated<number>;
+        /**
+         * ТЕНЬ ПОД ПОДЛОЖКОЙ: непрозрачность, 0..1 (по умолчанию 0 — без тени).
+         *
+         * Кружок без тени лежит В карте, с тенью — НАД ней, и на пёстрой застройке это разница между
+         * «пятно среди домов» и «метка поверх города».
+         */
+        frameShadow?: Interpolated<number>;
+        /** Сдвиг тени вниз в пикселях экрана (по умолчанию 3). */
+        frameShadowOffset?: Interpolated<number>;
+        /** Размытие тени в пикселях экрана (по умолчанию 6). */
+        frameShadowBlur?: Interpolated<number>;
+        /**
+         * Свой цвет тени. По умолчанию — цвет подложки, притемнённый: серая тень под цветным значком
+         * читается грязью, а потемневший собственный цвет — глубиной.
+         */
+        frameShadowColor?: Interpolated<string>;
         /**
          * Цвета частей составного значка (`layout.iconParts`), по порядку частей.
          *
@@ -3467,6 +3505,8 @@ declare class SymbolRenderer {
     private colorOf;
     private inStyleOrder;
     private draw;
+    /** Запись подложки этого слоя в атласе — по ней градиент знает высоту фигуры. */
+    private frameEntryOf;
     private ensureBuffers;
     /** Догружает недостающие глифы и иконки и просит перерисовать кадр. */
     private requestMissing;
@@ -7279,6 +7319,15 @@ interface RoadGraphOptions {
      * Без него сглаживание на длинных звеньях и срезает много, и сглаживает мало — см. `densifyLine`.
      */
     densify?: number;
+    /**
+     * ДЛИНА САМОГО БОЛЬШОГО КОЛЬЦА, метры. 0 — кольца не собирать.
+     *
+     * По ней кольцевая развязка отличается от квартала: и то и другое — замкнутый обход по сети, но
+     * круг это десятки метров, а квартал — сотни. Порог задаётся снаружи, потому что снаружи задан
+     * и масштаб: у генератора тайлов метры меркаторские и на широте Душанбе длиннее наземных в 1.28
+     * раза.
+     */
+    ringMax?: number;
 }
 declare function buildRoadGraph(axes: RoadAxis[], options?: RoadGraphOptions): RoadGraph;
 
@@ -7402,6 +7451,17 @@ interface MarkingOptions {
      * разметка целиком лежит внутри его же полотна, и вырезалась бы вся.
      */
     keepOut?: (x: number, y: number, chain: RoadChain) => boolean;
+    /**
+     * ГДЕ НА ПОДХОДЕ СТОИТ ПЕШЕХОДНЫЙ ПЕРЕХОД — расстояние ОТ УЗЛА вдоль оси, в метрах.
+     *
+     * Сам движок ставит его по отступу узла: перекрёсток кончился — через метр с небольшим переход.
+     * Для одной проезжей части это верно, а для улицы из нескольких — нет: узлы у них на
+     * перекрёстке стоят вразнобой, и переходы выходят лесенкой. Кто знает про соседей — тот и
+     * скажет, где ряд; вернул `null` — считаем сами, как раньше.
+     *
+     * Стоп-линия отмеряется ОТ ПЕРЕХОДА, поэтому едет вместе с ним и остаётся к нему прижатой.
+     */
+    crossingAt?: (chain: RoadChain, index: number, node: number) => number | null;
 }
 declare function roadMarkings(graph: RoadGraph, options?: MarkingOptions): Marking[];