react-native-maplibre-lite 0.2.5 → 0.2.6

package/src/components/navigatorVoiceCatalog.ts

@@ -1,316 +0,0 @@
-import AsyncStorage from '@react-native-async-storage/async-storage';
-
-import { isKnownPhraseKey, type VoicePhraseKey } from './navigatorVoiceKeys';
-
-/**
- * Каталог/манифест голосов навигатора и персист настроек. Порт
- * `webProject/src/map/navigationVoiceCatalog.ts` на нативную часть:
- * localStorage → AsyncStorage, плюс маппинг ключей фраз в URL клипов.
- */
-
-export type VoiceCatalogEntry = {
-    dir: string;
-    name: string;
-    locale: string;
-};
-
-/** Per-voice manifest from S3: phrase key → variant ids. */
-export type VoiceManifest = Record<string, string[]>;
-
-export type VoicePref = { dir: string } | { disabled: true };
-
-export type VoiceRuntime = {
-    catalogUrl: string;
-    catalog: VoiceCatalogEntry[];
-    selectedDir: string;
-    clipBaseUrl: string;
-    manifest: VoiceManifest | null;
-    enabled: boolean;
-};
-
-const LS_VOICE_PREF = 'maplite-navigator-voice-pref';
-const LS_VOICE_VOLUME = 'maplite-navigator-voice-volume';
-
-export type VoiceVolumeLevel = 1 | 2 | 3 | 4 | 5;
-
-const DEFAULT_VOICE_VOLUME_LEVEL: VoiceVolumeLevel = 5;
-
-export function volumeLevelToGain(level: VoiceVolumeLevel): number {
-    return level * 0.2;
-}
-
-export async function readVoiceVolumeLevel(): Promise<VoiceVolumeLevel> {
-    try {
-        const raw = await AsyncStorage.getItem(LS_VOICE_VOLUME);
-        if (!raw) return DEFAULT_VOICE_VOLUME_LEVEL;
-        const n = Number.parseInt(raw, 10);
-        if (n >= 1 && n <= 5) return n as VoiceVolumeLevel;
-    } catch {
-        /* ignore */
-    }
-    return DEFAULT_VOICE_VOLUME_LEVEL;
-}
-
-export async function writeVoiceVolumeLevel(level: VoiceVolumeLevel): Promise<void> {
-    try {
-        await AsyncStorage.setItem(LS_VOICE_VOLUME, String(level));
-    } catch {
-        /* ignore */
-    }
-}
-
-export async function readVoicePref(): Promise<VoicePref | null> {
-    try {
-        const raw = await AsyncStorage.getItem(LS_VOICE_PREF);
-        if (!raw) return null;
-        const parsed = JSON.parse(raw) as unknown;
-        if (
-            parsed &&
-            typeof parsed === 'object' &&
-            'disabled' in parsed &&
-            (parsed as { disabled: unknown }).disabled === true
-        ) {
-            return { disabled: true };
-        }
-        if (
-            parsed &&
-            typeof parsed === 'object' &&
-            'dir' in parsed &&
-            typeof (parsed as { dir: unknown }).dir === 'string'
-        ) {
-            const dir = (parsed as { dir: string }).dir.trim();
-            if (dir) return { dir };
-        }
-    } catch {
-        /* ignore */
-    }
-    return null;
-}
-
-export async function writeVoicePref(pref: VoicePref): Promise<void> {
-    try {
-        await AsyncStorage.setItem(LS_VOICE_PREF, JSON.stringify(pref));
-    } catch {
-        /* ignore */
-    }
-}
-
-const HTTP_URL_PREFIX_RE = /^https?:\/\//i;
-
-function trimTrailingSlashes(s: string): string {
-    return s.replace(/\/+$/, '');
-}
-
-/** Strips `?query` and `#hash` — catalog URLs are plain paths. */
-function stripUrlQueryAndHash(url: string): string {
-    const q = url.indexOf('?');
-    const h = url.indexOf('#');
-    let end = url.length;
-    if (q >= 0) end = Math.min(end, q);
-    if (h >= 0) end = Math.min(end, h);
-    return url.slice(0, end);
-}
-
-function pathnameSegments(pathname: string): string[] {
-    return pathname.split('/').filter(Boolean);
-}
-
-/**
- * Parses `http(s)://host[:port]/path` without the URL API (Hermes-safe).
- */
-function parseHttpUrl(url: string): { origin: string; pathname: string } | null {
-    const bare = stripUrlQueryAndHash(url.trim());
-    if (!HTTP_URL_PREFIX_RE.test(bare)) return null;
-
-    const schemeEnd = bare.indexOf('://');
-    const rest = bare.slice(schemeEnd + 3);
-    const slash = rest.indexOf('/');
-    const authority = slash === -1 ? rest : rest.slice(0, slash);
-    if (!authority) return null;
-
-    const pathname = slash === -1 ? '/' : rest.slice(slash);
-    const origin = bare.slice(0, schemeEnd + 3) + authority;
-    return { origin, pathname };
-}
-
-export function resolveVoiceCatalogUrl(url: string): string | null {
-    const t = url.trim();
-    if (!t) return null;
-    return parseHttpUrl(t) ? t : null;
-}
-
-/** Base URL for a voice directory: `.../voices/{dir}`. */
-export function voiceDirBaseUrl(catalogUrl: string, dir: string): string {
-    const parsed = parseHttpUrl(catalogUrl);
-    if (!parsed) {
-        throw new Error('voiceDirBaseUrl: invalid catalog URL');
-    }
-
-    const parts = pathnameSegments(parsed.pathname);
-    if (parts.length > 0 && parts[parts.length - 1]!.toLowerCase().endsWith('.json')) {
-        parts.pop();
-    }
-
-    const safeDir = dir.trim().replace(/[/\\]+/g, '');
-    if (!safeDir) {
-        throw new Error('voiceDirBaseUrl: empty dir');
-    }
-    parts.push(safeDir);
-
-    return trimTrailingSlashes(`${parsed.origin}/${parts.join('/')}`);
-}
-
-function voiceManifestUrl(baseUrl: string): string {
-    return `${trimTrailingSlashes(baseUrl)}/data.json`;
-}
-
-export async function fetchVoiceCatalog(catalogUrl: string): Promise<VoiceCatalogEntry[]> {
-    const res = await fetch(catalogUrl);
-    if (!res.ok) {
-        throw new Error(`voice catalog fetch failed: ${res.status}`);
-    }
-    const data = (await res.json()) as unknown;
-    if (!Array.isArray(data)) {
-        throw new Error('voice catalog: expected JSON array');
-    }
-    const entries: VoiceCatalogEntry[] = [];
-    for (const item of data) {
-        if (
-            item &&
-            typeof item === 'object' &&
-            typeof (item as VoiceCatalogEntry).dir === 'string' &&
-            typeof (item as VoiceCatalogEntry).name === 'string'
-        ) {
-            const e = item as VoiceCatalogEntry;
-            entries.push({
-                dir: e.dir.trim(),
-                name: e.name,
-                locale: typeof e.locale === 'string' ? e.locale : 'RU',
-            });
-        }
-    }
-    if (entries.length === 0) {
-        throw new Error('voice catalog: empty');
-    }
-    return entries;
-}
-
-export async function fetchVoiceManifest(clipBaseUrl: string): Promise<VoiceManifest> {
-    const res = await fetch(voiceManifestUrl(clipBaseUrl));
-    if (!res.ok) {
-        throw new Error(`voice manifest fetch failed: ${res.status}`);
-    }
-    const data = (await res.json()) as unknown;
-    if (!data || typeof data !== 'object' || Array.isArray(data)) {
-        throw new Error('voice manifest: expected JSON object');
-    }
-    const manifest: VoiceManifest = {};
-    for (const [key, value] of Object.entries(data as Record<string, unknown>)) {
-        if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
-            manifest[key] = value as string[];
-        }
-    }
-    return manifest;
-}
-
-function resolveSelectedDir(catalog: VoiceCatalogEntry[], pref: VoicePref | null): string {
-    if (pref && 'dir' in pref) {
-        const found = catalog.find((e) => e.dir === pref.dir);
-        if (found) return found.dir;
-    }
-    return catalog[0]!.dir;
-}
-
-/**
- * Loads catalog + user preference + optional per-voice manifest.
- * When pref is `{ disabled: true }`, returns `enabled: false` and `manifest: null`.
- */
-export async function loadVoiceRuntime(catalogUrl: string): Promise<VoiceRuntime | null> {
-    const resolved = resolveVoiceCatalogUrl(catalogUrl);
-    if (!resolved) return null;
-
-    const catalog = await fetchVoiceCatalog(resolved);
-    const pref = await readVoicePref();
-    const selectedDir = resolveSelectedDir(catalog, pref);
-    const clipBaseUrl = voiceDirBaseUrl(resolved, selectedDir);
-
-    if (pref != null && 'disabled' in pref && pref.disabled === true) {
-        return {
-            catalogUrl: resolved,
-            catalog,
-            selectedDir,
-            clipBaseUrl,
-            manifest: null,
-            enabled: false,
-        };
-    }
-
-    const manifest = await fetchVoiceManifest(clipBaseUrl);
-    return {
-        catalogUrl: resolved,
-        catalog,
-        selectedDir,
-        clipBaseUrl,
-        manifest,
-        enabled: true,
-    };
-}
-
-/** Reload manifest after user picks another voice (same catalog URL). */
-export async function reloadVoiceForDir(
-    catalogUrl: string,
-    catalog: VoiceCatalogEntry[],
-    dir: string
-): Promise<Pick<VoiceRuntime, 'selectedDir' | 'clipBaseUrl' | 'manifest' | 'enabled'>> {
-    const entry = catalog.find((e) => e.dir === dir);
-    if (!entry) {
-        throw new Error(`voice dir not in catalog: ${dir}`);
-    }
-    const clipBaseUrl = voiceDirBaseUrl(catalogUrl, entry.dir);
-    const manifest = await fetchVoiceManifest(clipBaseUrl);
-    await writeVoicePref({ dir: entry.dir });
-    return {
-        selectedDir: entry.dir,
-        clipBaseUrl,
-        manifest,
-        enabled: true,
-    };
-}
-
-function pickVariant(manifest: VoiceManifest, key: VoicePhraseKey): string {
-    const vars = manifest[key];
-    if (!vars?.length) return 'var1';
-    return vars[Math.floor(Math.random() * vars.length)] ?? 'var1';
-}
-
-/** clipId для S3: `{key}_{variant}`. */
-function phraseKeyToClipId(manifest: VoiceManifest, key: VoicePhraseKey, variant: string): string {
-    return `${key}_${variant}`;
-}
-
-/**
- * Преобразует список ключей фраз (из веб-части) в список URL клипов
- * `{clipBaseUrl}/{key}_{variant}.mp3`. Неизвестные / отсутствующие в
- * манифесте ключи пропускаются.
- */
-export function keysToClipUrls(
-    manifest: VoiceManifest,
-    clipBaseUrl: string,
-    keys: string[]
-): string[] {
-    const base = trimTrailingSlashes(clipBaseUrl);
-    const variants = new Map<VoicePhraseKey, string>();
-    const urls: string[] = [];
-    for (const raw of keys) {
-        if (!isKnownPhraseKey(raw)) continue;
-        const key = raw;
-        if (!(key in manifest)) continue;
-        let variant = variants.get(key);
-        if (!variant) {
-            variant = pickVariant(manifest, key);
-            variants.set(key, variant);
-        }
-        urls.push(`${base}/${phraseKeyToClipId(manifest, key, variant)}.mp3`);
-    }
-    return urls;
-}

package/src/components/navigatorVoiceKeys.ts

@@ -1,132 +0,0 @@
-/**
- * Фиксированные ключи клипов навигатора (схема проекта). Зеркало
- * `webProject/src/map/navigationVoiceKeys.ts` — веб-часть присылает эти
- * ключи в событии `navigatorVoice`, нативная часть мапит их в аудио.
- * Варианты (`var1`, …) и наличие записей — только из S3 voice manifest.
- */
-export const VOICE_PHRASE_KEYS = [
-    'maneuver_sharp_left',
-    'maneuver_turn_left',
-    'maneuver_slight_left',
-    'maneuver_straight',
-    'maneuver_slight_right',
-    'maneuver_turn_right',
-    'maneuver_sharp_right',
-    'maneuver_arrival',
-    'maneuver_waypoint',
-    'maneuver_enter_roundabout',
-    'maneuver_leave_roundabout',
-    'maneuver_keep_left',
-    'maneuver_keep_right',
-    'maneuver_uturn',
-    'maneuver_uturn_left',
-    'maneuver_uturn_right',
-    'maneuver_default',
-    'exit_1',
-    'exit_2',
-    'exit_3',
-    'exit_4',
-    'exit_5',
-    'exit_6',
-    'exit_7',
-    'exit_8',
-    'exit_9',
-    'exit_10',
-    'exit_11',
-    'exit_12',
-    'roundabout_take_exit',
-    'prefix_via',
-    'connector_and',
-    'unit_meter',
-    'unit_meters_2_4',
-    'unit_meters_5_plus',
-    'unit_kilometer',
-    'unit_kilometers_2_4',
-    'unit_kilometers_5_plus',
-    'route_started',
-    'route_recalculated',
-    'arrived_title',
-    'arrival_at_destination',
-    'waypoint_reached',
-    'off_route',
-    'num_1',
-    'num_2',
-    'num_3',
-    'num_4',
-    'num_5',
-    'num_6',
-    'num_7',
-    'num_8',
-    'num_9',
-    'num_10',
-    'num_11',
-    'num_12',
-    'num_13',
-    'num_14',
-    'num_15',
-    'num_16',
-    'num_17',
-    'num_18',
-    'num_19',
-    'num_20',
-    'num_30',
-    'num_40',
-    'num_50',
-    'num_60',
-    'num_70',
-    'num_80',
-    'num_90',
-    'num_100',
-    'num_200',
-    'num_300',
-    'num_400',
-    'num_500',
-    'num_600',
-    'num_700',
-    'num_800',
-    'num_900',
-    'num_km_1',
-    'num_km_2',
-    'num_km_3',
-    'num_km_4',
-    'num_km_5',
-    'num_km_6',
-    'num_km_7',
-    'num_km_8',
-    'num_km_9',
-    'num_km_10',
-    'num_km_11',
-    'num_km_12',
-    'num_km_13',
-    'num_km_14',
-    'num_km_15',
-    'num_km_16',
-    'num_km_17',
-    'num_km_18',
-    'num_km_19',
-    'num_km_20',
-    'num_km_30',
-    'num_km_40',
-    'num_km_50',
-    'num_km_60',
-    'num_km_70',
-    'num_km_80',
-    'num_km_90',
-    'num_km_100',
-    'num_km_200',
-    'num_km_300',
-    'num_km_400',
-    'num_km_500',
-    'num_km_600',
-    'num_km_700',
-    'num_km_800',
-    'num_km_900',
-] as const;
-
-export type VoicePhraseKey = (typeof VOICE_PHRASE_KEYS)[number];
-
-const VOICE_PHRASE_KEY_SET = new Set<string>(VOICE_PHRASE_KEYS);
-
-export function isKnownPhraseKey(key: string): key is VoicePhraseKey {
-    return VOICE_PHRASE_KEY_SET.has(key);
-}

package/src/components/useNavigatorVoice.ts

@@ -1,96 +0,0 @@
-import { useCallback, useEffect, useState } from 'react';
-
-import {
-    loadVoiceRuntime,
-    readVoiceVolumeLevel,
-    reloadVoiceForDir,
-    writeVoicePref,
-    writeVoiceVolumeLevel,
-    type VoiceCatalogEntry,
-    type VoiceManifest,
-    type VoiceRuntime,
-    type VoiceVolumeLevel,
-} from './navigatorVoiceCatalog';
-
-/**
- * Нативное владение голосом навигатора: загрузка каталога/манифеста,
- * выбор голоса/громкости и персист (AsyncStorage). Веб шлёт только ключи
- * фраз; маппинг в аудио и воспроизведение — на стороне RN.
- */
-export type NavigatorVoiceController = {
-    runtime: VoiceRuntime | null;
-    catalog: VoiceCatalogEntry[];
-    selectedDir: string | null;
-    manifest: VoiceManifest | null;
-    clipBaseUrl: string | null;
-    voiceEnabled: boolean;
-    volumeLevel: VoiceVolumeLevel;
-    selectVoice: (dir: string) => Promise<void>;
-    selectVolume: (level: VoiceVolumeLevel) => void;
-    disableVoice: () => Promise<void>;
-};
-
-export function useNavigatorVoice(voiceUrl: string | undefined): NavigatorVoiceController {
-    const [runtime, setRuntime] = useState<VoiceRuntime | null>(null);
-    const [volumeLevel, setVolumeLevel] = useState<VoiceVolumeLevel>(5);
-
-    useEffect(() => {
-        let cancelled = false;
-        void readVoiceVolumeLevel().then((lvl) => {
-            if (!cancelled) setVolumeLevel(lvl);
-        });
-        if (!voiceUrl) {
-            setRuntime(null);
-            return () => {
-                cancelled = true;
-            };
-        }
-        void loadVoiceRuntime(voiceUrl)
-            .then((rt) => {
-                if (!cancelled) setRuntime(rt);
-            })
-            .catch((err) => {
-                console.warn('[maplite] navigator voice catalog failed', err);
-                if (!cancelled) setRuntime(null);
-            });
-        return () => {
-            cancelled = true;
-        };
-    }, [voiceUrl]);
-
-    const selectVoice = useCallback(
-        async (dir: string) => {
-            if (!runtime) return;
-            try {
-                const reloaded = await reloadVoiceForDir(runtime.catalogUrl, runtime.catalog, dir);
-                setRuntime((prev) => (prev ? { ...prev, ...reloaded } : prev));
-            } catch (err) {
-                console.warn('[maplite] failed to switch navigator voice', { dir, err });
-            }
-        },
-        [runtime]
-    );
-
-    const selectVolume = useCallback((level: VoiceVolumeLevel) => {
-        setVolumeLevel(level);
-        void writeVoiceVolumeLevel(level);
-    }, []);
-
-    const disableVoice = useCallback(async () => {
-        await writeVoicePref({ disabled: true });
-        setRuntime((prev) => (prev ? { ...prev, enabled: false, manifest: null } : prev));
-    }, []);
-
-    return {
-        runtime,
-        catalog: runtime?.catalog ?? [],
-        selectedDir: runtime?.selectedDir ?? null,
-        manifest: runtime?.manifest ?? null,
-        clipBaseUrl: runtime?.clipBaseUrl ?? null,
-        voiceEnabled: Boolean(runtime?.enabled && runtime.manifest),
-        volumeLevel,
-        selectVoice,
-        selectVolume,
-        disableVoice,
-    };
-}