clxx 3.0.2 → 3.0.4

package/build/MapLocationSelection/buildSelectedLocation.js

@@ -0,0 +1,123 @@
+"use strict";
+// 把 reverseGeocode 结果 + 候选 POI 拼装成对外的 SelectedLocation。
+//
+// 单一信源：MapLocationSelection 组件的「确定按钮 onSelect」、列表头部
+// 「当前位置」虚拟项、独立的 `getLocation()` 函数式 API 全部走这里。
+// 之前 handleConfirm 与 currentItem useMemo 各自维护一份逐字对齐的内联
+// 实现（用注释「STAY-IN-SYNC 双源同步」标注），任何一边改动都得手动同步
+// 另一边——抽到这里后变成单点维护，从根源上消除「列表第一条显示什么 ≠
+// 确定后提交什么」的体感错位风险。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NEAREST_POI_FALLBACK_RADIUS_M = void 0;
+exports.splitAdcode = splitAdcode;
+exports.buildSelectedLocation = buildSelectedLocation;
+// nearestPoi 的距离阈值：80m 覆盖典型楼栋 / 出入口 / 地铁站口的
+// 距离半径，再远就不能代表「用户在地图上选的那个位置」。
+//
+// 用途：当用户没主动点列表项时，借 poiList[0]（最近 POI）的 name / address
+// 作为兜底——避免高德 / 百度 reverseGeocode 在没楼宇位置 fallback 到
+// township 粗粒度的"陆家嘴街道""高桥镇"之类。
+exports.NEAREST_POI_FALLBACK_RADIUS_M = 80;
+// 国标 GB/T 2260 编码切分：6 位 adcode → 省（前 2 + "0000"）/ 市（前 4
+// + "00"）/ 区（完整 6 位）。
+//
+// SDK 直接给 6 位 adcode（高德 r.addressComponent.adcode、百度
+// result.addressComponents.adcode），切分一次就能得到三层 code，**完全
+// 不需要外部映射表**（如 RegionPicker/data.ts）。
+//
+// Corner case：
+//   - 不设区的地级市（东莞 441900、中山 442000、嘉峪关 620200 等）：
+//     cityCode === districtCode，是国标允许的预期结果；
+//   - 直辖市：cityCode 是市辖区码（如 110100），不是 110000；provinceCode
+//     才是 110000；
+//   - 输入非法（undefined / 不是 6 位数字）：返回 undefined，由调用方把
+//     三个 *Code 字段都置 undefined。
+function splitAdcode(adcode) {
+    if (!adcode || !/^\d{6}$/.test(adcode))
+        return undefined;
+    return {
+        provinceCode: `${adcode.slice(0, 2)}0000`,
+        cityCode: `${adcode.slice(0, 4)}00`,
+        districtCode: adcode,
+    };
+}
+// 拼装优先级链（与原 handleConfirm 内联实现 1:1 等价）：
+//
+//   * name：pickedPoi.name → nearestPoi.name → geo.name → 行政区划兜底
+//          → 经纬度兜底。POI 名（楼栋/商铺级）放在最前。
+//   * address：geo.address → nearestPoi.address → pickedPoi.address →
+//             行政区划文本兜底 → 经纬度兜底。geo.address 缺省市区前缀
+//             时（如只有"中山路 100 号"）自动在前面拼接 adminText。
+//   * province / city / district：永远以 geo 为准（POI 经常缺这些字段）。
+//   * provinceCode / cityCode / districtCode：geo.adcode 切分（splitAdcode）。
+//
+// 兜底链最尾端（reverseGeocode 彻底失败 + 无 POI 兜底）：用经纬度字符串
+// 拼接，保证 name + address 永远不为空，业务方拿到的数据永远可读。
+//
+// 行政区划文本拼接的去重：直辖市 city === province 时只保留省名，避免
+// 出现"上海市上海市浦东新区"这种重复。
+function buildSelectedLocation(center, geo, options = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const { pickedPoi, candidatePoi } = options;
+    let nearestPoi = null;
+    if (!pickedPoi && candidatePoi) {
+        if (typeof candidatePoi.distance === "number" &&
+            candidatePoi.distance <= exports.NEAREST_POI_FALLBACK_RADIUS_M) {
+            nearestPoi = candidatePoi;
+        }
+    }
+    const nearestPoiName = ((_a = nearestPoi === null || nearestPoi === void 0 ? void 0 : nearestPoi.name) === null || _a === void 0 ? void 0 : _a.trim()) || "";
+    const nearestPoiAddress = ((_b = nearestPoi === null || nearestPoi === void 0 ? void 0 : nearestPoi.address) === null || _b === void 0 ? void 0 : _b.trim()) || "";
+    let name = ((_c = pickedPoi === null || pickedPoi === void 0 ? void 0 : pickedPoi.name) === null || _c === void 0 ? void 0 : _c.trim()) ||
+        nearestPoiName ||
+        ((_d = geo === null || geo === void 0 ? void 0 : geo.name) === null || _d === void 0 ? void 0 : _d.trim()) ||
+        "";
+    let address = ((_e = geo === null || geo === void 0 ? void 0 : geo.address) === null || _e === void 0 ? void 0 : _e.trim()) ||
+        nearestPoiAddress ||
+        ((_f = pickedPoi === null || pickedPoi === void 0 ? void 0 : pickedPoi.address) === null || _f === void 0 ? void 0 : _f.trim()) ||
+        "";
+    const province = ((_g = geo === null || geo === void 0 ? void 0 : geo.province) === null || _g === void 0 ? void 0 : _g.trim()) || undefined;
+    const city = ((_h = geo === null || geo === void 0 ? void 0 : geo.city) === null || _h === void 0 ? void 0 : _h.trim()) || undefined;
+    const district = ((_j = geo === null || geo === void 0 ? void 0 : geo.district) === null || _j === void 0 ? void 0 : _j.trim()) || undefined;
+    const adminText = [
+        province,
+        city && city !== province ? city : "",
+        district,
+    ]
+        .filter((s) => !!s && s.length > 0)
+        .join("");
+    if (!address) {
+        address =
+            adminText ||
+                `经纬度 ${center[0].toFixed(6)},${center[1].toFixed(6)}`;
+    }
+    else if (adminText &&
+        !address.startsWith(adminText) &&
+        !address.includes(adminText)) {
+        // address 已有但缺省市区前缀（如只返回"中山路 100 号"）→ 在前面补"省市区"，
+        // 例如：上海市浦东新区 + 中山路 100 号 = "上海市浦东新区中山路 100 号"。
+        // 双重检查 startsWith / includes：高德 formattedAddress 有时已经内嵌
+        // 省市区前缀，这时不能重复拼接。
+        address = `${adminText}${address}`;
+    }
+    if (!name) {
+        name =
+            district ||
+                city ||
+                province ||
+                `位置 ${center[0].toFixed(6)},${center[1].toFixed(6)}`;
+    }
+    const codes = splitAdcode(geo === null || geo === void 0 ? void 0 : geo.adcode);
+    return {
+        name,
+        address,
+        longitude: center[0],
+        latitude: center[1],
+        city,
+        province,
+        district,
+        provinceCode: codes === null || codes === void 0 ? void 0 : codes.provinceCode,
+        cityCode: codes === null || codes === void 0 ? void 0 : codes.cityCode,
+        districtCode: codes === null || codes === void 0 ? void 0 : codes.districtCode,
+    };
+}

package/build/MapLocationSelection/createProvider.d.ts

@@ -0,0 +1,8 @@
+import type { MapProvider, MapProviderType } from "./provider";
+export interface CreateProviderOptions {
+    provider?: MapProviderType;
+    amapKey?: string;
+    securityJsCode?: string;
+    bmapAk?: string;
+}
+export declare function createProvider(opts: CreateProviderOptions): MapProvider;

package/build/MapLocationSelection/createProvider.js

@@ -0,0 +1,33 @@
+"use strict";
+// MapProvider 工厂：根据配置选择 amap / bmap 实现并校验必传字段。
+//
+// 抽出位置：原本内联在 index.tsx 的 createProvider，因为 getLocation
+// （独立的纯函数式定位 API，见 getLocation.ts）也需要相同的 provider
+// 创建逻辑——避免「UI 走 amap / 函数式调用走 amap」两条路径出现配置
+// 校验差异（一边漏校 securityJsCode、一边漏报 ak 缺失等）。
+//
+// CreateProviderOptions 也是 MapLocationSelectionProps / GetLocationOptions
+// 的最小公共子集——两边都通过 extends 承接这组字段，调用方传一次配置即可。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProvider = createProvider;
+const provider_amap_1 = require("./provider.amap");
+const provider_bmap_1 = require("./provider.bmap");
+function createProvider(opts) {
+    var _a;
+    const type = (_a = opts.provider) !== null && _a !== void 0 ? _a : "amap";
+    if (type === "bmap") {
+        if (!opts.bmapAk) {
+            throw new Error("[MapLocationSelection] provider=bmap 时 bmapAk 必填");
+        }
+        return new provider_bmap_1.BMapProvider({
+            ak: opts.bmapAk,
+        });
+    }
+    if (!opts.amapKey) {
+        throw new Error("[MapLocationSelection] provider=amap 时 amapKey 必填");
+    }
+    return new provider_amap_1.AMapProvider({
+        amapKey: opts.amapKey,
+        securityJsCode: opts.securityJsCode,
+    });
+}

package/build/MapLocationSelection/getLocation.d.ts

@@ -0,0 +1,8 @@
+import { type CreateProviderOptions } from "./createProvider";
+import { type SelectedLocation } from "./types";
+export interface GetLocationOptions extends CreateProviderOptions {
+    timeout?: number;
+    initialCity?: string;
+    allowIpFallback?: boolean;
+}
+export declare function getLocation(options?: GetLocationOptions): Promise<SelectedLocation>;

package/build/MapLocationSelection/getLocation.js

@@ -0,0 +1,112 @@
+"use strict";
+// 独立的函数式定位 API：不挂组件直接拿到一份 SelectedLocation。
+//
+// 与 MapLocationSelection 组件的关系：
+//   * 组件 = 「打开地图 → 用户拖图选位置 → 点确定 → onSelect」交互式流程；
+//   * getLocation = 「直接拿一份当前 GPS 位置的 SelectedLocation」无 UI 流程。
+//
+// 数据格式与组件 onSelect 完全一致——两边都通过 buildSelectedLocation 这同
+// 一个 helper 拼装，**不可能出现字段差异**。业务方拿 getLocation 的返回值
+// 与拿组件的 onSelect 回调可以走同一条业务处理路径。
+//
+// 内部依赖：
+//   * createProvider：与组件复用同一份配置校验（amapKey / bmapAk 必填检查）；
+//   * provider.initHeadless：**仅加载 SDK + 创建 service 类，不创建 Map 实例**——
+//     不挂 DOM、不下载瓦片、不渲染。SDK 的 Geolocation / Geocoder /
+//     PlaceSearch / LocalSearch 这几个 service 类**本身就独立于 Map**（高德
+//     官方示例直接 new AMap.Geolocation()、百度 LocalSearch 文档明示第一参数
+//     可传 Point/city 而非 Map），所以走 headless 是 SDK 设计支持的，不是 hack；
+//   * provider.geolocate：拿 GPS 经纬度（去抖、坐标系自洽、IP 兜底过滤）；
+//   * provider.reverseGeocode：拿省市区 + 详细地址 + adcode；
+//   * provider.searchAround：拿周边 POI（用于 nearestPoi 兜底，避免名字
+//     fallback 到"街道镇"粗粒度）；
+//   * buildSelectedLocation：与组件 handleConfirm 共用的拼装逻辑。
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocation = getLocation;
+const buildSelectedLocation_1 = require("./buildSelectedLocation");
+const createProvider_1 = require("./createProvider");
+const types_1 = require("./types");
+function getLocation() {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
+        var _a;
+        const timeout = (_a = options.timeout) !== null && _a !== void 0 ? _a : 15000;
+        let provider = null;
+        let timer = null;
+        try {
+            // createProvider 内置必填字段校验（amapKey / bmapAk 缺失立即抛 Error）。
+            provider = (0, createProvider_1.createProvider)(options);
+            const work = runGetLocation(provider, options);
+            if (timeout > 0 && Number.isFinite(timeout)) {
+                const timeoutPromise = new Promise((_, reject) => {
+                    timer = window.setTimeout(() => {
+                        reject(new Error(`[getLocation] 超时（${timeout}ms）`));
+                    }, timeout);
+                });
+                return yield Promise.race([work, timeoutPromise]);
+            }
+            return yield work;
+        }
+        finally {
+            if (timer !== null) {
+                window.clearTimeout(timer);
+                timer = null;
+            }
+            if (provider) {
+                try {
+                    provider.destroy();
+                }
+                catch (_b) {
+                    // ignore
+                }
+            }
+        }
+    });
+}
+// 真正的工作流。拆出来的目的：让 getLocation 的 try/finally 只负责资源
+// 清理，业务流程在这里更清晰，且方便 Promise.race 包装超时。
+function runGetLocation(provider, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // headless 模式：仅加载 SDK + 创建 service 类，不创建 Map 实例。
+        // 详见 provider.initHeadless 接口注释——节省 ~5-10 个瓦片请求 +
+        // ~100-300ms 渲染开销，无需挂任何 DOM 容器。
+        yield provider.initHeadless({ initialCity: options.initialCity });
+        const pos = yield provider.geolocate({
+            allowIpFallback: options.allowIpFallback,
+        });
+        if (!pos) {
+            throw new Error("[getLocation] 定位失败：用户拒绝授权 / 浏览器不支持 GPS / 非 https 环境" +
+                (options.allowIpFallback
+                    ? ""
+                    : "（如需接受 IP 兜底定位，请传 allowIpFallback: true）"));
+        }
+        // 反查 + 周边搜索并行——总耗时 ≈ max(reverseGeocode, searchAround)，
+        // 而非串行 sum。两者互不依赖，并行是无成本的体感优化。
+        // 周边搜索的目的：拿到 nearestPoi 兜底 name——与组件 handleConfirm 在
+        // 「未点列表 + 点确定」分支的兜底链一致（详见 buildSelectedLocation 的
+        // pickedPoi / candidatePoi 注释）。
+        // pageSize=20 / radius=200 与组件默认值对齐，行为完全等价。
+        const [geo, around] = yield Promise.all([
+            provider.reverseGeocode(pos).catch(() => null),
+            provider
+                .searchAround(pos, { page: 1, pageSize: 20, radius: 200 })
+                .catch(() => ({ pois: [], hasMore: false })),
+        ]);
+        // candidatePoi 的 distance 字段口径：组件 UI 层通过 rewriteDistanceFromCenter
+        // 在 commit 时把 SDK 自带 distance 重写为「POI ↔ centerPin」（haversine 重算）。
+        // getLocation 没有 UI commit 路径，但 buildSelectedLocation 用 distance 字段
+        // 判断「是否在 80m 兜底阈值内」——必须保证口径一致，所以这里手动重算一次。
+        const top = around.pois[0];
+        const candidatePoi = top
+            ? Object.assign(Object.assign({}, top), { distance: (0, types_1.haversineMeters)(pos[0], pos[1], top.location.lng, top.location.lat) }) : null;
+        return (0, buildSelectedLocation_1.buildSelectedLocation)(pos, geo, { candidatePoi });
+    });
+}

package/build/MapLocationSelection/index.d.ts

@@ -0,0 +1,16 @@
+import { type SelectedLocation } from "./types";
+import { type CreateProviderOptions } from "./createProvider";
+export type { SelectedLocation } from "./types";
+export { getLocation, type GetLocationOptions } from "./getLocation";
+export interface MapLocationSelectionProps extends CreateProviderOptions {
+    primary?: string;
+    initialCenter?: [number, number];
+    initialCity?: string;
+    searchRadius?: number;
+    pageSize?: number;
+    allowIpFallback?: boolean;
+    onClose?: () => void;
+    onSelect?: (loc: SelectedLocation) => void;
+}
+export declare function MapLocationSelection(props: MapLocationSelectionProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function showMapLocationSelection(props: MapLocationSelectionProps): void;