osmgl 0.31.31 → 0.31.32

package/dist/speed-index-kbbQG2xX.d.ts

@@ -1,197 +0,0 @@
-import Pbf from 'pbf';
-import { aT as SpeedLimit } from './model-mshqbG69.js';
-
-/**
- * Разбор Mapbox Vector Tile (spec 2.1) — наш тайлсервер отдаёт именно его
- * (схема OpenMapTiles v3: building / transportation / water / landuse / poi …).
- *
- * Читаем «лениво»: сначала только оглавление слоёв, геометрию каждой фичи
- * распаковываем по требованию. На тайл с 20 тыс. фич это разница между
- * 40 мс и 3 мс, когда генератору нужен один слой из пятнадцати.
- */
-declare const enum GeomType {
-    Unknown = 0,
-    Point = 1,
-    LineString = 2,
-    Polygon = 3
-}
-type PropValue = string | number | boolean | null;
-/** Кольцо/линия: плоский массив [x0,y0,x1,y1,...] в координатах тайла [0..extent]. */
-type Ring = number[];
-declare class VectorTileFeature {
-    private pbf;
-    readonly keys: string[];
-    readonly values: PropValue[];
-    readonly extent: number;
-    id?: number;
-    type: GeomType;
-    properties: Record<string, PropValue>;
-    /** Позиция блока геометрии в буфере; -1 — геометрии нет. Пишется читателем полей. */
-    geomOffset: number;
-    constructor(pbf: Pbf, keys: string[], values: PropValue[], extent: number);
-    static read(pbf: Pbf, end: number, keys: string[], values: PropValue[], extent: number): VectorTileFeature;
-    /** Кольца/линии фичи. Для полигонов внешние и внутренние идут вперемешку — см. splitPolygons. */
-    loadGeometry(): Ring[];
-    /** BBox фичи в координатах тайла — дешёвый отсев до триангуляции. */
-    bbox(): [number, number, number, number];
-}
-declare class VectorTileLayer {
-    private pbf;
-    version: number;
-    name: string;
-    extent: number;
-    readonly featureOffsets: number[];
-    readonly keys: string[];
-    readonly values: PropValue[];
-    constructor(pbf: Pbf);
-    static read(pbf: Pbf, end: number): VectorTileLayer;
-    get length(): number;
-    feature(i: number): VectorTileFeature;
-    /** Итератор по всем фичам слоя. */
-    features(): Generator<VectorTileFeature>;
-}
-declare class VectorTile {
-    readonly layers: Record<string, VectorTileLayer>;
-    constructor(buffer: ArrayBuffer | Uint8Array);
-}
-/**
- * Разбивает кольца полигона на группы «внешнее + его дырки».
- * Ориентация по знаку площади: в MVT внешние кольца по часовой (положительная
- * площадь в системе с Y вниз), дырки — против.
- */
-declare function splitPolygons(rings: Ring[]): {
-    outer: Ring;
-    holes: Ring[];
-}[];
-
-/**
- * ОГРАНИЧЕНИЕ СКОРОСТИ ПО ИНДЕКСУ ТАЙЛА — источник правды для портов (`SpeedLimits.kt`, `SpeedLimitIndex.swift`)
- * и натива (`native/src/navigram/speed_limit.cpp`, откуда логика и пришла, 17.10.2026).
- *
- * Зачем. Навигатор спрашивал знак раз в 0.9 с запросом по НАРИСОВАННОМУ: `project` + до четырёх
- * `queryRenderedFeatures` (дорога точкой с допуском 3, 7, 12 px и застройка в 12 px) в потоке карты перед кадром.
- * Перебор слоёв стиля и всех треугольников домов тайла под машиной — 18 мс на Redmi Note 11, провал кадра «раз в
- * 0.9 с» (PLAN N6). Здесь сырой тайл основы ОДИН раз разбирается в индекс по слоям тайла: отрезки `transportation`
- * сеткой 32² и признаки застройки (`landuse` городских классов — многоугольниками, `building`/`housenumber`/`poi` —
- * битовой сеткой присутствия 256²). Ответ по готовому индексу — микросекунды. Где собирать индекс (воркер, пул,
- * очередь) — решает платформа: сборка чистая, на входе байты, на выходе неизменяемый индекс.
- *
- * ★ Отличие от запроса по нарисованному — осознанное: дорога — БЛИЖАЙШАЯ проезжая в пределах 12 px (а не верхняя
- * по порядку отрисовки среди попавших в 3/7/12 px), застройка — дом/номер дома/POI в радиусе 12 px или городской
- * `landuse` под точкой. Запрос по нарисованному домов и подписей рядом с осью дороги почти не находил (заливка
- * ловится попаданием центра, символы не ловятся вовсе), и «в городе ли» решал фактически один `landuse`.
- * Сверка со старым ответом — `scripts/speed-index-vs-query.mjs`, цифры — в `native/PLAN.md`.
- *
- * Решение по найденному — та же чистая часть `speedLimitFromFeatures`: дорога одной фичей `transportation`,
- * застройка — одной фичей `building` (её слой и есть признак, свойства не читаются).
- */
-
-/** Допуск поиска дороги, CSS-пиксели на зуме камеры. */
-declare const SPEED_ROAD_TOLERANCE = 12;
-/** Сетка дорог: 32² клеток на тайл с буфером — у z14 клетка ≈ 90 м, дорог в клетке единицы–десятки. */
-declare const SPEED_ROAD_GRID = 32;
-/** Сетка присутствия домов/номеров/POI: 256² бит (8 КБ) — у z14 клетка ≈ 11 м, как допуск 12 px на зуме ведения. */
-declare const SPEED_PRESENCE_GRID = 256;
-declare const SPEED_NAME_TOLERANCE = 16;
-/** Название улицы: местное, русское (если есть) и номер дороги (`M41`). */
-interface RoadName {
-    name: string;
-    nameRu: string | null;
-    ref: string | null;
-}
-/** Городской `landuse`: кольца подряд (`ends[i]` — конец кольца i в `points`, пары x, y) и рамка для отсева. */
-interface UrbanPolygon {
-    points: Float32Array;
-    ends: number[];
-    minX: number;
-    minY: number;
-    maxX: number;
-    maxY: number;
-}
-/**
- * Индекс одного сырого тайла: дороги и застройка. Неизменяемый после сборки — его можно отдавать между потоками.
- * Координаты — единицы тайла (`extent`). Сетки накрывают тайл с буфером в четверть тайла с каждой стороны:
- * фичи соседей лежат за краем.
- */
-declare class SpeedLimitIndex {
-    extent: number;
-    /** Свойства дорог (только `ROAD_KEYS`), в порядке фич тайла. */
-    readonly roads: Record<string, PropValue>[];
-    /** Отрезки: `ax, ay, bx, by` подряд (float32, как у натива); `segmentRoad[i]` — номер дороги отрезка i. */
-    segments: Float32Array<ArrayBuffer>;
-    segmentRoad: Uint32Array<ArrayBuffer>;
-    /** Сетка дорог `SPEED_ROAD_GRID`², в клетке — номера отрезков (CSR: начало клетки в `roadCellStart`). */
-    roadCellStart: Uint32Array<ArrayBuffer>;
-    roadCellItems: Uint32Array<ArrayBuffer>;
-    /** Городские `landuse` — многоугольники (их в тайле единицы–десятки), отсев рамкой. */
-    readonly urban: UrbanPolygon[];
-    /** Присутствие домов, номеров и POI — битовая сетка `SPEED_PRESENCE_GRID`² (слова по 32 бита). */
-    readonly presence: Uint32Array<ArrayBuffer>;
-    /** Названия улиц (`transportation_name`, только `NAME_KEYS`) — отрезки и сетка, как у дорог. */
-    readonly names: Record<string, PropValue>[];
-    nameSegments: Float32Array<ArrayBuffer>;
-    nameSegmentRoad: Uint32Array<ArrayBuffer>;
-    nameCellStart: Uint32Array<ArrayBuffer>;
-    nameCellItems: Uint32Array<ArrayBuffer>;
-    get segmentCount(): number;
-    /** Собрать из сырого MVT; битый тайл — пустой индекс (не исключение: знак не повод ронять поток). */
-    static build(raw: Uint8Array): SpeedLimitIndex;
-    /** Клетка сетки `n`² по координате тайла; за краем сетки — к краю. */
-    cellOf(v: number, n: number): number;
-    private buildRoads;
-    /** Сетка `SPEED_ROAD_GRID`² по отрезкам (CSR): клетки → номера отрезков; сначала счёт, потом раскладка. */
-    private grid;
-    /** Линии `transportation_name` с именем или номером; тропы — мимо (по ним не ездят). */
-    private buildNames;
-    private mark;
-    private buildPresence;
-    private buildLanduse;
-    /** Номер ближайшей проезжей дороги в радиусе `radius` от точки; нет — −1. Равные расстояния — первая дорога тайла. */
-    roadIndexNear(x: number, y: number, radius: number): number;
-    /** Номер ближайшего названия улицы (`names`) в радиусе `radius`; нет — −1. Правила — как у `roadIndexNear`. */
-    nameIndexNear(x: number, y: number, radius: number): number;
-    /** Свойства ближайшего названия (`name`, `name:ru`, `ref`) в радиусе `radius`; нет — null. */
-    nameNear(x: number, y: number, radius: number): Record<string, PropValue> | null;
-    private nearest;
-    /** Свойства ближайшей проезжей дороги в радиусе `radius`; нет — null. */
-    roadNear(x: number, y: number, radius: number): Record<string, PropValue> | null;
-    /** Застройка: дом/номер дома/POI в радиусе `radius` (по клеткам сетки) или городской `landuse` под точкой. */
-    urbanNear(x: number, y: number, radius: number): boolean;
-    /** Сколько бит присутствия поднято (сверка портов). */
-    presenceCount(): number;
-}
-/** Допуск `px` CSS-пикселей на зуме камеры `zoom` → единицы тайла зума `tileZ` (наклон не учитывается: под машиной он мал). */
-declare function speedTileRadius(px: number, zoom: number, tileZ: number, extent: number): number;
-/**
- * Решение в точке тайла `x`, `y` (единицы тайла): ближайшая дорога в `roadRadius` → `speedLimitFromFeatures`, застройка
- * в `aroundRadius`. Дороги рядом нет — null (вызывающий держит прежний знак).
- */
-declare function speedLimitFromIndex(index: SpeedLimitIndex, x: number, y: number, roadRadius: number, aroundRadius: number, exact?: boolean): SpeedLimit | null;
-/**
- * Название улицы в точке тайла (`fx`, `fy` — доля точки в тайле из `pickSpeedTile`), допуск — `SPEED_NAME_TOLERANCE`
- * пикселей на зуме камеры `zoom`. Рядом названия нет — null (у безымянного проезда показывать нечего).
- */
-declare function roadNameAtTile(index: SpeedLimitIndex, tileZ: number, fx: number, fy: number, zoom: number): RoadName | null;
-/** Номер тайла, как его видит выбор тайла основы. */
-interface SpeedTileId {
-    z: number;
-    x: number;
-    y: number;
-    wrap?: number;
-}
-/**
- * Тайл основы под точкой: самый подробный из `tiles`, у которого есть сырые данные (`hasRaw`); при равном зуме —
- * первый в списке. Ответ — номер в списке и доля точки внутри тайла; нет — null.
- */
-declare function pickSpeedTile(tiles: SpeedTileId[], lng: number, lat: number, hasRaw: (i: number) => boolean): {
-    index: number;
-    fx: number;
-    fy: number;
-} | null;
-/**
- * Знак в точке карты по готовому индексу тайла (`fx`, `fy` — доля точки в тайле из `pickSpeedTile`), допуски —
- * `SPEED_ROAD_TOLERANCE`/`SPEED_AROUND_TOLERANCE` пикселей на зуме камеры `zoom`.
- */
-declare function speedLimitAtTile(index: SpeedLimitIndex, tileZ: number, fx: number, fy: number, zoom: number, exact?: boolean): SpeedLimit | null;
-
-export { GeomType as G, type PropValue as P, type RoadName as R, type SpeedTileId as S, VectorTile as V, VectorTileFeature as a, VectorTileLayer as b, SpeedLimitIndex as c, SPEED_NAME_TOLERANCE as d, SPEED_PRESENCE_GRID as e, SPEED_ROAD_GRID as f, SPEED_ROAD_TOLERANCE as g, speedLimitAtTile as h, speedLimitFromIndex as i, speedTileRadius as j, type Ring as k, pickSpeedTile as p, roadNameAtTile as r, splitPolygons as s };