osmgl 0.12.0 → 0.12.2

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`), по порядку частей.
          *
@@ -1645,7 +1683,8 @@ interface SurfaceLayerSpec extends LayerBase {
     groundField?: boolean;
     bevelDrop?: number;
     paint: MaterialPaint & {
-        color: Interpolated<string>;
+        /** Цвет поверхности; `{ from, darken }` — «как у такого-то слоя» (см. `ColorFrom`). */
+        color: Interpolated<string> | ColorFrom;
         opacity?: Interpolated<number>;
         /** Насколько темнее борт и юбка, 0..1. */
         sideShade?: Interpolated<number>;
@@ -1653,8 +1692,11 @@ interface SurfaceLayerSpec extends LayerBase {
          * Цвет борта и юбки. По умолчанию у УТОПЛЕННОЙ поверхности это фон стиля —
          * то есть земля вокруг: стенка утопленной воды и есть берег, и красить её
          * водой значит обводить реку тёмной каймой.
+         *
+         * `{ from, darken }` — «как у такого-то слоя» (см. `ColorFrom`): так бордюр полотна берёт цвет
+         * обводки дорог из темы и меняется вместе с ней, а не остаётся одним хексом на все палитры.
          */
-        sideColor?: Interpolated<string>;
+        sideColor?: Interpolated<string> | ColorFrom;
         /**
          * Насколько борт освещается КАК ЗЕМЛЯ (0 — по своей нормали, 1 — по
          * вертикальной). У берега нормаль горизонтальная, света он почти не
@@ -3467,6 +3509,8 @@ declare class SymbolRenderer {
     private colorOf;
     private inStyleOrder;
     private draw;
+    /** Запись подложки этого слоя в атласе — по ней градиент знает высоту фигуры. */
+    private frameEntryOf;
     private ensureBuffers;
     /** Догружает недостающие глифы и иконки и просит перерисовать кадр. */
     private requestMissing;
@@ -7279,6 +7323,15 @@ interface RoadGraphOptions {
      * Без него сглаживание на длинных звеньях и срезает много, и сглаживает мало — см. `densifyLine`.
      */
     densify?: number;
+    /**
+     * ДЛИНА САМОГО БОЛЬШОГО КОЛЬЦА, метры. 0 — кольца не собирать.
+     *
+     * По ней кольцевая развязка отличается от квартала: и то и другое — замкнутый обход по сети, но
+     * круг это десятки метров, а квартал — сотни. Порог задаётся снаружи, потому что снаружи задан
+     * и масштаб: у генератора тайлов метры меркаторские и на широте Душанбе длиннее наземных в 1.28
+     * раза.
+     */
+    ringMax?: number;
 }
 declare function buildRoadGraph(axes: RoadAxis[], options?: RoadGraphOptions): RoadGraph;
 

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`), по порядку частей.
          *
@@ -1645,7 +1683,8 @@ interface SurfaceLayerSpec extends LayerBase {
     groundField?: boolean;
     bevelDrop?: number;
     paint: MaterialPaint & {
-        color: Interpolated<string>;
+        /** Цвет поверхности; `{ from, darken }` — «как у такого-то слоя» (см. `ColorFrom`). */
+        color: Interpolated<string> | ColorFrom;
         opacity?: Interpolated<number>;
         /** Насколько темнее борт и юбка, 0..1. */
         sideShade?: Interpolated<number>;
@@ -1653,8 +1692,11 @@ interface SurfaceLayerSpec extends LayerBase {
          * Цвет борта и юбки. По умолчанию у УТОПЛЕННОЙ поверхности это фон стиля —
          * то есть земля вокруг: стенка утопленной воды и есть берег, и красить её
          * водой значит обводить реку тёмной каймой.
+         *
+         * `{ from, darken }` — «как у такого-то слоя» (см. `ColorFrom`): так бордюр полотна берёт цвет
+         * обводки дорог из темы и меняется вместе с ней, а не остаётся одним хексом на все палитры.
          */
-        sideColor?: Interpolated<string>;
+        sideColor?: Interpolated<string> | ColorFrom;
         /**
          * Насколько борт освещается КАК ЗЕМЛЯ (0 — по своей нормали, 1 — по
          * вертикальной). У берега нормаль горизонтальная, света он почти не
@@ -3467,6 +3509,8 @@ declare class SymbolRenderer {
     private colorOf;
     private inStyleOrder;
     private draw;
+    /** Запись подложки этого слоя в атласе — по ней градиент знает высоту фигуры. */
+    private frameEntryOf;
     private ensureBuffers;
     /** Догружает недостающие глифы и иконки и просит перерисовать кадр. */
     private requestMissing;
@@ -7279,6 +7323,15 @@ interface RoadGraphOptions {
      * Без него сглаживание на длинных звеньях и срезает много, и сглаживает мало — см. `densifyLine`.
      */
     densify?: number;
+    /**
+     * ДЛИНА САМОГО БОЛЬШОГО КОЛЬЦА, метры. 0 — кольца не собирать.
+     *
+     * По ней кольцевая развязка отличается от квартала: и то и другое — замкнутый обход по сети, но
+     * круг это десятки метров, а квартал — сотни. Порог задаётся снаружи, потому что снаружи задан
+     * и масштаб: у генератора тайлов метры меркаторские и на широте Душанбе длиннее наземных в 1.28
+     * раза.
+     */
+    ringMax?: number;
 }
 declare function buildRoadGraph(axes: RoadAxis[], options?: RoadGraphOptions): RoadGraph;