@mapslibvn/react-native 0.4.0 → 0.5.0

package/dist/session-B7Fu_s_b.d.ts

@@ -0,0 +1,557 @@
+/**
+ * Nguồn POI và profile archive (spec 07/09 mục 4). Đây là nguồn sự thật duy nhất cho API, SDK và
+ * pipeline: thêm profile mới = thêm một dòng vào POI_SOURCE_PROFILES + một lần export-tiles.
+ */
+declare const POI_SOURCES: readonly ["osm", "overture", "fsq"];
+type PoiSource = (typeof POI_SOURCES)[number];
+
+/** Kiểu dữ liệu Places API (spec 6.1) dùng chung cho Worker và SDK. */
+interface PlaceCategory {
+    code: string;
+    group: string;
+    name_vi: string;
+    name_en: string;
+}
+interface PlaceAddress {
+    housenumber?: string;
+    street?: string;
+    ward?: string;
+    province?: string;
+    text?: string;
+}
+interface Place {
+    id: string;
+    name: string;
+    category: PlaceCategory | null;
+    lat: number;
+    lng: number;
+    address: PlaceAddress;
+    contact?: Record<string, unknown> | null;
+    hours?: unknown;
+    quality_score: number | null;
+    status: 'active' | 'closed' | 'pending' | 'rejected';
+    updated_at: string;
+}
+interface PlaceSource {
+    source: 'osm' | 'overture' | 'fsq';
+    source_id: string;
+    role: 'primary' | 'secondary';
+}
+interface PlaceDetails extends Place {
+    sources: PlaceSource[];
+    attribution: {
+        text: string;
+        html: string;
+    };
+}
+type GeocodePrecision = 'rooftop' | 'alley' | 'interpolated' | 'street' | 'ward' | 'district' | 'province';
+type AutocompleteType = 'poi' | 'street' | 'address' | 'area';
+interface AutocompleteItem {
+    type: AutocompleteType;
+    id?: string;
+    name: string;
+    secondary: string;
+    lat: number;
+    lng: number;
+    precision?: GeocodePrecision;
+    score: number;
+    bbox?: [number, number, number, number];
+    /** Tên thay thế (OSM `alt_name`/`old_name`) đã khớp truy vấn, ví dụ "Công Lý" (spec 6.3). */
+    matched_alt?: string;
+}
+interface GeocodeMatched {
+    housenumber?: string;
+    street?: string;
+    ward?: string;
+    province?: string;
+    former?: {
+        ward?: string;
+        district?: string;
+        province?: string;
+    };
+}
+interface GeocodeItem {
+    lat: number;
+    lng: number;
+    precision: GeocodePrecision;
+    confidence: number;
+    matched: GeocodeMatched;
+    display_name: string;
+    bbox?: [number, number, number, number];
+}
+interface ReverseAddress {
+    approx_housenumber?: string;
+    street?: string;
+    ward?: string;
+    province?: string;
+    display_name: string;
+}
+interface ReverseResponse {
+    address: ReverseAddress;
+    nearest_poi: Place | null;
+}
+type EditKind = 'create' | 'update' | 'close' | 'reopen' | 'report';
+/** Trường được phép sửa/khai khi đóng góp (spec 6.1 + 6.5). */
+interface EditChanges {
+    name?: string;
+    lat?: number;
+    lng?: number;
+    category?: string;
+    housenumber?: string;
+    street?: string;
+    ward?: string;
+    province?: string;
+    address_text?: string;
+    contact?: {
+        phone?: string[];
+        website?: string[];
+        facebook?: string;
+    };
+    /** Chuỗi opening_hours OSM hoặc {osm: chuỗi}. */
+    hours?: string | {
+        osm: string;
+    };
+}
+interface SuggestEditRequest {
+    /** Bắt buộc trừ kind='create'. */
+    poi_id?: string;
+    kind: EditKind;
+    changes?: EditChanges;
+    photo_url?: string;
+    note?: string;
+    /** Chuỗi ổn định theo người dùng cuối do app nhúng cấp — server chỉ lưu bản băm. */
+    end_user_token: string;
+}
+interface SuggestEditResponse {
+    edit_id: number;
+    status: 'pending' | 'auto_approved';
+    /** POI đích; với kind='create' là id POI mới (pending cho tới khi được duyệt). */
+    poi_id: string | null;
+}
+/** POI đọc từ tile lớp `poi` khi người dùng bấm — SDK web và React Native dùng chung. */
+interface PoiFeature {
+    id: string;
+    name: string;
+    category: string;
+    group: string;
+    lngLat: [number, number];
+}
+/** Phương tiện cho `GET /v1/directions` (spec dẫn đường A). */
+type TravelMode = 'motorbike' | 'car' | 'walk';
+type DirectionsLang = 'vi' | 'en';
+/** Loại bước rẽ theo tập cố định của MapsLibVN — không phụ thuộc engine. */
+type ManeuverKind = 'depart' | 'arrive' | 'continue' | 'slight_right' | 'slight_left' | 'turn_right' | 'turn_left' | 'sharp_right' | 'sharp_left' | 'uturn_right' | 'uturn_left' | 'ramp_straight' | 'ramp_right' | 'ramp_left' | 'exit_right' | 'exit_left' | 'keep_right' | 'keep_left' | 'merge' | 'merge_right' | 'merge_left' | 'roundabout_enter' | 'roundabout_exit' | 'ferry_enter' | 'ferry_exit' | 'elevator' | 'steps' | 'escalator' | 'building_enter' | 'building_exit' | 'other';
+interface RouteStep {
+    kind: ManeuverKind;
+    instruction: string;
+    /** Câu rẽ ngắn gọn để đọc lúc còn cách xa (spec B); Valhalla không trả → null. */
+    verbal_alert: string | null;
+    verbal_pre: string | null;
+    verbal_post: string | null;
+    street_names: string[];
+    distance_m: number;
+    duration_s: number;
+    /** Chỉ số điểm trong polyline của CẢ tuyến (đã dịch qua các leg). */
+    shape_begin: number;
+    shape_end: number;
+    /** [lng, lat] điểm bắt đầu bước. */
+    location: [number, number];
+    /** Số lối ra khi `kind = roundabout_enter`, còn lại null. */
+    roundabout_exit: number | null;
+}
+interface RouteLeg {
+    distance_m: number;
+    duration_s: number;
+    /** Chỉ số điểm đầu của leg trong polyline tuyến. */
+    shape_offset: number;
+    steps: RouteStep[];
+}
+interface Route {
+    mode: TravelMode;
+    distance_m: number;
+    duration_s: number;
+    /** [minLng, minLat, maxLng, maxLat] */
+    bbox: [number, number, number, number];
+    /** polyline6 của cả tuyến — giải mã bằng `decodePolyline6` → `[lng, lat][]`. */
+    geometry: string;
+    legs: RouteLeg[];
+    flags: {
+        toll: boolean;
+        highway: boolean;
+        ferry: boolean;
+    };
+}
+interface Waypoint {
+    /** [lng, lat] điểm người dùng gửi. */
+    location: [number, number];
+    /** [lng, lat] điểm trên tuyến gần nhất (đầu leg tương ứng). */
+    snapped: [number, number];
+    name: string | null;
+}
+interface DirectionsResponse {
+    routes: Route[];
+    waypoints: Waypoint[];
+    attribution: string;
+    /** Thông tin chẩn đoán, không phải hợp đồng ổn định. */
+    engine?: {
+        name: string;
+        graph: string | null;
+    };
+}
+
+type Theme = 'light' | 'dark';
+interface ClientOptions {
+    /** Khoá API dạng mlv_live_… */
+    apiKey: string;
+    /** Gốc API, ví dụ https://maps-api.example.com */
+    baseUrl: string;
+    /** Cho phép tiêm fetch cho test hoặc môi trường không có global fetch. */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Header thêm cho mọi request, ví dụ `X-Bundle-Id` cho khoá `mobile` (spec 6.4).
+     * Không ghi đè được `X-Api-Key`.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Tập nguồn POI cho bản đồ và Places API (spec 07/09). Mặc định cả ba nguồn.
+     * Áp cho autocomplete/search/nearby/reverse và `styleUrl`; `getPlace`/`geocode` không lọc.
+     */
+    poiSources?: readonly PoiSource[];
+}
+interface AttributionResponse {
+    text: string;
+    html: string;
+    links: {
+        text: string;
+        href: string;
+        license?: string;
+    }[];
+}
+interface DirectionsOptions {
+    /** [lat, lng] — vĩ độ trước, cùng quy ước với `near`. */
+    from: [number, number];
+    to: [number, number];
+    /** Tối đa 5 điểm dừng, mỗi điểm [lat, lng]. */
+    via?: [number, number][];
+    /** Mặc định máy chủ: `motorbike`. */
+    mode?: TravelMode;
+    /** Mặc định máy chủ: `vi`. */
+    lang?: DirectionsLang;
+    /** Xin thêm một tuyến thay thế (bị bỏ qua khi có `via`). */
+    alternatives?: boolean;
+}
+declare function createClient(options: ClientOptions): {
+    baseUrl: string;
+    attribution: () => Promise<AttributionResponse>;
+    styleUrl: (theme: Theme) => string;
+    autocomplete: (q: string, opts?: {
+        near?: [number, number];
+        limit?: number;
+        types?: AutocompleteType[];
+    }) => Promise<{
+        items: AutocompleteItem[];
+    }>;
+    search: (q: string, opts?: {
+        category?: string;
+        near?: [number, number];
+        radius?: number;
+        bbox?: [number, number, number, number];
+        limit?: number;
+        offset?: number;
+    }) => Promise<{
+        items: Place[];
+        total: number;
+    }>;
+    nearby: (opts: {
+        lat: number;
+        lng: number;
+        radius?: number;
+        category?: string;
+        limit?: number;
+    }) => Promise<{
+        items: Place[];
+    }>;
+    getPlace: (id: string) => Promise<PlaceDetails>;
+    geocode: (q: string, opts?: {
+        near?: [number, number];
+        limit?: number;
+    }) => Promise<{
+        items: GeocodeItem[];
+    }>;
+    reverse: (lat: number, lng: number) => Promise<ReverseResponse>;
+    /** Chỉ đường (spec dẫn đường A). Response dùng [lng, lat]; tham số vào dùng [lat, lng]. */
+    directions: (opts: DirectionsOptions) => Promise<DirectionsResponse>;
+    /** Gửi đóng góp/sửa POI (spec 6.1). Khoá phải có scope edits:write. */
+    suggestEdit: (edit: SuggestEditRequest) => Promise<SuggestEditResponse>;
+};
+type MapsLibVNClient = ReturnType<typeof createClient>;
+
+/**
+ * Biến đổi style JSON thuần (không cần Map đang chạy) — dùng cho React Native, nơi wrapper
+ * không có API đổi layout property của lớp có sẵn. Web dùng `applyLanguage` lúc chạy nhưng
+ * chia sẻ `nameExpression`/`isNameLabelLayer` từ đây.
+ */
+
+type Lang = 'vi' | 'en';
+
+/**
+ * Polyline mã hoá kiểu Google với precision 1e6 (Valhalla `legs[].shape`).
+ * Toạ độ trả về theo thứ tự GeoJSON `[lng, lat]`.
+ */
+declare function decodePolyline6(encoded: string): [number, number][];
+
+/** Một điểm định vị. Lớp dán (web/RN) đổi từ API nền tảng sang dạng này. */
+interface GeoFix {
+    lng: number;
+    lat: number;
+    /** Bán kính sai số (m). Thiếu → coi là 10 m. */
+    accuracy_m?: number;
+    /** Độ so với bắc, thuận chiều kim đồng hồ; null/undefined khi đứng yên hoặc không có. */
+    heading?: number | null;
+    speed_mps?: number | null;
+    /** ms epoch — nguồn thời gian duy nhất của máy trạng thái. */
+    timestamp: number;
+}
+/** Nguồn tuyến. `MapsLibVNClient` của `createClient` thoả kiểu này không cần bọc. */
+interface RouteProvider {
+    directions(opts: DirectionsOptions): Promise<DirectionsResponse>;
+}
+interface PositionError {
+    code: 'denied' | 'unavailable' | 'timeout';
+    message: string;
+    raw?: unknown;
+}
+/** Nguồn vị trí do lớp dán cung cấp; core chỉ định nghĩa kiểu để web và RN cùng hình. */
+interface PositionSource {
+    subscribe(onFix: (fix: GeoFix) => void, onError?: (error: PositionError) => void): () => void;
+}
+type NavigationStatus = 'idle' | 'navigating' | 'off_route' | 'rerouting' | 'arrived' | 'stopped';
+interface NavigationThresholds {
+    /** Ngưỡng lệch cơ sở; hiệu dụng = max(offRoute_m, 1.5 × accuracy_m). */
+    offRoute_m: number;
+    /** Số fix liên tiếp ngoài ngưỡng để xác nhận lệch. */
+    offRouteFixes: number;
+    /** … và đã kéo dài ít nhất bấy nhiêu giây (theo timestamp fix). */
+    offRouteSeconds: number;
+    /** Fix kém hơn thì bỏ, không cập nhật gì. */
+    maxAccuracy_m: number;
+    /** Đọc "Trong X nữa, …" khi còn ≤. */
+    approach_m: number;
+    /** Đọc câu rẽ khi còn ≤. */
+    pre_m: number;
+    /** Bán kính đến nơi / qua điểm via. */
+    arrive_m: number;
+    rerouteCooldown_s: number;
+    rerouteMaxFailures: number;
+}
+/** Số khởi điểm theo spec B mục 4.3; chốt lại sau thực địa (Task 20). */
+declare const NAVIGATION_THRESHOLDS: Readonly<Record<TravelMode, NavigationThresholds>>;
+interface NavigationProgress {
+    status: NavigationStatus;
+    route: Route;
+    routeIndex: number;
+    legIndex: number;
+    /** Chỉ số step PHẲNG qua mọi leg (spec B 4.4). */
+    stepIndex: number;
+    step: RouteStep;
+    /** Step có điểm rẽ kế tiếp; null khi step hiện tại là arrive cuối. */
+    nextStep: RouteStep | null;
+    /** [lng, lat] điểm đã bám lên tuyến. */
+    snapped: [number, number];
+    /** Hướng đi (độ): heading GPS khi speed_mps > 1, còn không thì hướng đoạn tuyến. */
+    bearing: number;
+    /** Chỉ số đỉnh đầu của đoạn polyline đang ở. */
+    shapeIndex: number;
+    traveled_m: number;
+    remaining_m: number;
+    /** ETA: phần còn lại của step hiện tại theo tỉ lệ + tổng duration các step sau. */
+    remaining_s: number;
+    /** Tới điểm rẽ của nextStep; 0 khi không còn. */
+    distanceToStep_m: number;
+    /** Khoảng cách vuông góc từ fix tới tuyến. */
+    offRoute_m: number;
+    fix: GeoFix;
+}
+interface Announcement {
+    text: string;
+    kind: 'depart' | 'post' | 'approach' | 'pre' | 'arrive';
+    stepIndex: number;
+    /** 3 = câu rẽ / đến nơi / khởi hành, 2 = "Trong X nữa", 1 = verbal_post. */
+    priority: 1 | 2 | 3;
+}
+interface NavigationEvents {
+    status: {
+        status: NavigationStatus;
+        previous: NavigationStatus;
+    };
+    progress: NavigationProgress;
+    step: {
+        stepIndex: number;
+        step: RouteStep;
+    };
+    waypoint: {
+        legIndex: number;
+        waypoint: Waypoint;
+    };
+    offRoute: {
+        distance_m: number;
+        fix: GeoFix;
+    };
+    reroute: {
+        reason: 'off_route' | 'manual';
+        response: DirectionsResponse;
+    };
+    rerouteFailed: {
+        error: unknown;
+        attempts: number;
+        final: boolean;
+    };
+    announce: Announcement;
+    arrive: {
+        waypoint: Waypoint;
+        fix: GeoFix;
+    };
+}
+interface NavigatorOptions {
+    response: DirectionsResponse;
+    /** Mặc định 0. */
+    routeIndex?: number;
+    /** Bắt buộc khi `reroute` là 'auto' (mặc định). */
+    provider?: RouteProvider;
+    /** Mặc định 'auto'. */
+    reroute?: 'auto' | 'manual';
+    /** Mặc định 'vi'; dùng cho câu "Trong X nữa" và request tính lại. */
+    lang?: DirectionsLang;
+    thresholds?: Partial<NavigationThresholds>;
+}
+interface Navigator {
+    readonly status: NavigationStatus;
+    readonly progress: NavigationProgress | null;
+    /** Đồng bộ. Fix kém accuracy hoặc timestamp không tăng bị bỏ. */
+    update(fix: GeoFix): void;
+    /** Thay tuyến: reset bước, lịch đọc, bộ đếm lệch; fix kế tiếp bám trên toàn tuyến. */
+    setRoute(response: DirectionsResponse, routeIndex?: number): void;
+    /** Gọi provider ngay (bỏ cooldown và trần lỗi). */
+    reroute(): Promise<void>;
+    stop(): void;
+    on<K extends keyof NavigationEvents>(event: K, handler: (e: NavigationEvents[K]) => void): void;
+    off<K extends keyof NavigationEvents>(event: K, handler: (e: NavigationEvents[K]) => void): void;
+}
+
+/** "85 mét", "1,2 ki-lô-mét" (viết đủ để giọng đọc phát âm đúng), "12 ki-lô-mét"; en tương ứng. */
+declare function formatDistance(m: number, lang?: DirectionsLang): string;
+/** Bản ngắn cho UI: "85 m", "1,2 km", "12 km". */
+declare function formatDistanceShort(m: number): string;
+
+interface SimulateOptions {
+    /** Mặc định theo mode: walk 1.4, motorbike 8, car 12. */
+    speed_mps?: number;
+    /** Mặc định 1. */
+    interval_s?: number;
+    /** Mặc định 8. */
+    accuracy_m?: number;
+    /** Nhiễu vị trí đều trong hình tròn bán kính này; mặc định 0. */
+    jitter_m?: number;
+    /** Mặc định 1. */
+    seed?: number;
+    /** Mặc định 1_700_000_000_000. */
+    start_ms?: number;
+}
+/** Đi dọc polyline với vận tốc hằng; heading = hướng đoạn; thuần và xác định. */
+declare function simulateFixes(route: Route, opts?: SimulateOptions): GeoFix[];
+
+/** Máy trạng thái dẫn đường thuần (spec B mục 4.4–4.5): không DOM, không timer, thời gian từ fix. */
+declare function createNavigator(opts: NavigatorOptions): Navigator;
+
+/** Bộ đọc câu — mặc định Expo ở `@mapslibvn/react-native/expo`; app thay bằng TTS riêng được. */
+interface Speaker {
+    /** Cắt câu đang đọc nếu `priority` ≥ ưu tiên câu đó; thấp hơn thì xếp hàng. */
+    speak(text: string, priority: 1 | 2 | 3, lang: DirectionsLang): void;
+    cancel(): void;
+    /** Có giọng khớp `lang` không; phiên gọi một lần lúc `start()` để phát `voiceUnavailable`. */
+    available(lang: DirectionsLang): Promise<boolean>;
+    /** Nhận `voice: { rate, volume }` của `start()`; tuỳ chọn. */
+    setOptions?(options: {
+        rate?: number;
+        volume?: number;
+    }): void;
+}
+interface KeepAwake {
+    activate(): Promise<void> | void;
+    deactivate(): Promise<void> | void;
+}
+interface AudioSession {
+    activate(): Promise<void>;
+    deactivate(): Promise<void>;
+}
+interface BackgroundUnavailable {
+    reason: 'task_not_defined' | 'not_configured' | 'permission' | 'unsupported';
+    message: string;
+}
+/** `PositionSource` của core cộng hai móc tuỳ chọn; phiên nhận diện bằng `'setMode' in source`. */
+interface SessionPositionSource extends PositionSource {
+    /** Phiên gọi trước `subscribe` với `mode` của tuyến (iOS activityType, Android ưu tiên). */
+    setMode?(mode: TravelMode): void;
+    /** Nguồn báo đã rơi về tiền cảnh; phiên phát lại thành `backgroundUnavailable`. */
+    onBackgroundUnavailable?(cb: (e: BackgroundUnavailable) => void): void;
+}
+interface NavigationSessionOptions {
+    provider: RouteProvider;
+    /** Bắt buộc để `start()` chạy; thiếu → reject với `MISSING_SOURCE_MESSAGE`. */
+    source?: SessionPositionSource;
+    /** Thiếu → không đọc, không phát `voiceUnavailable`. */
+    speech?: Speaker;
+    keepAwake?: KeepAwake;
+    audio?: AudioSession;
+}
+interface NavigationSessionStartOptions {
+    response: DirectionsResponse;
+    /** Mặc định 0. */
+    routeIndex?: number;
+    /** Mặc định 'auto'. */
+    reroute?: 'auto' | 'manual';
+    /** Mặc định 'vi'. */
+    lang?: DirectionsLang;
+    /** Mặc định true khi có `speech`. */
+    voice?: boolean | {
+        rate?: number;
+        volume?: number;
+    };
+    thresholds?: Partial<NavigationThresholds>;
+    /** Mặc định true khi có `keepAwake`. */
+    keepAwake?: boolean;
+}
+interface SessionEvents extends NavigationEvents {
+    /** Tuyến hiện tại đổi: `start()`, `setRoute()`, hoặc tính lại xong. Map gắn vào vẽ theo đây. */
+    route: {
+        response: DirectionsResponse;
+        routeIndex: number;
+    };
+    positionError: PositionError;
+    voiceUnavailable: undefined;
+    /** Nguồn vị trí không chạy nền được, đã rơi về tiền cảnh (một lần mỗi `start`). */
+    backgroundUnavailable: BackgroundUnavailable;
+    /** Phiên đã dừng nguồn vị trí: đến nơi hoặc app gọi `stop()`. */
+    end: {
+        reason: 'arrived' | 'stopped';
+    };
+}
+interface NavigationSession {
+    /** Resolve sau khi đã đăng ký nguồn vị trí (có thể chờ hộp thoại quyền). Reject chỉ khi thiếu `source`. */
+    start(opts: NavigationSessionStartOptions): Promise<void>;
+    stop(): Promise<void>;
+    reroute(): Promise<void>;
+    setRoute(response: DirectionsResponse, routeIndex?: number): void;
+    /** 'idle' khi chưa start hoặc đã stop; 'navigating' ngay sau start (core chỉ đổi ở fix đầu). */
+    readonly status: NavigationStatus;
+    readonly state: NavigationProgress | null;
+    /** Tuyến hiện tại — map gắn muộn vẽ lại từ đây; `stop()` không xoá. */
+    readonly response: DirectionsResponse | null;
+    readonly routeIndex: number;
+    on<K extends keyof SessionEvents>(event: K, handler: (e: SessionEvents[K]) => void): void;
+    off<K extends keyof SessionEvents>(event: K, handler: (e: SessionEvents[K]) => void): void;
+}
+declare const MISSING_SOURCE_MESSAGE = "Phi\u00EAn d\u1EABn \u0111\u01B0\u1EDDng thi\u1EBFu ngu\u1ED3n v\u1ECB tr\u00ED: truy\u1EC1n source (v\u00ED d\u1EE5 expoLocationSource() t\u1EEB @mapslibvn/react-native/expo)";
+declare function createNavigationSession(opts: NavigationSessionOptions): NavigationSession;
+
+export { type AudioSession as A, type BackgroundUnavailable as B, decodePolyline6 as C, type DirectionsResponse as D, formatDistance as E, formatDistanceShort as F, type GeoFix as G, simulateFixes as H, type KeepAwake as K, type Lang as L, type MapsLibVNClient as M, type NavigationSessionOptions as N, type PoiSource as P, type Route as R, type SessionPositionSource as S, type TravelMode as T, type Speaker as a, type SessionEvents as b, type NavigationSession as c, type NavigationSessionStartOptions as d, type NavigationProgress as e, type NavigationStatus as f, type Theme as g, type PoiFeature as h, type AutocompleteItem as i, type PositionSource as j, type Announcement as k, type DirectionsLang as l, type DirectionsOptions as m, MISSING_SOURCE_MESSAGE as n, type ManeuverKind as o, NAVIGATION_THRESHOLDS as p, type NavigationEvents as q, type NavigationThresholds as r, type Place as s, type PositionError as t, type RouteLeg as u, type RouteProvider as v, type RouteStep as w, createClient as x, createNavigationSession as y, createNavigator as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mapslibvn/react-native",
-  "version": "0.4.0",
-  "description": "React Native bindings MapsLibVN: <MapsLibVNMap>, <Marker>, useMap, usePlaces — bọc @maplibre/maplibre-react-native",
+  "version": "0.5.0",
+  "description": "React Native bindings MapsLibVN: <MapsLibVNMap>, <Marker>, useMap, usePlaces, dẫn đường (createNavigationSession, useNavigation; entry /expo cho định vị nền + TTS) — bọc @maplibre/maplibre-react-native",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./expo": {
+      "types": "./dist/expo/index.d.ts",
+      "import": "./dist/expo/index.js",
+      "default": "./dist/expo/index.js"
     }
   },
   "files": [
@@ -22,9 +27,31 @@
   "sideEffects": false,
   "peerDependencies": {
     "@maplibre/maplibre-react-native": "^11.3.0",
+    "expo-audio": ">=1.0.10",
+    "expo-keep-awake": ">=15.0.6",
+    "expo-location": ">=19.0.6",
+    "expo-speech": ">=14.0.6",
+    "expo-task-manager": ">=14.0.6",
     "react": ">=19.1.0",
     "react-native": ">=0.80.0"
   },
+  "peerDependenciesMeta": {
+    "expo-audio": {
+      "optional": true
+    },
+    "expo-keep-awake": {
+      "optional": true
+    },
+    "expo-location": {
+      "optional": true
+    },
+    "expo-speech": {
+      "optional": true
+    },
+    "expo-task-manager": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@maplibre/maplibre-react-native": "^11.3.8",
     "@testing-library/react": "^16.3.0",
@@ -35,7 +62,7 @@
     "react-native": "^0.81.0",
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
-    "@mapslibvn/core": "0.4.0"
+    "@mapslibvn/core": "0.5.0"
   },
   "scripts": {
     "build": "tsup",