clxx 3.0.2 → 3.0.4

package/build/MapLocationSelection/loader.amap.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 高德地图 SDK 动态加载器
+ *
+ * 设计目标：
+ *   - clxx 库被静态 import 时绝不携带高德地图 SDK；
+ *   - 只有用户真正使用 MapLocationSelection 时才通过运行时 import 触发拉取；
+ *   - 同一密钥在同一个页面只加载一次，多次调用复用同一个 Promise。
+ *
+ * 实现方式：
+ *   通过动态 `import` 一个由 Blob URL 包装的远程脚本（loader.js），
+ *   等价于在页面里插入 `<script src="https://webapi.amap.com/loader.js"></script>`。
+ *   这样既满足“动态 import”的语义（不会进入 clxx 的静态依赖图），
+ *   又避免了对 `@amap/amap-jsapi-loader` npm 包的硬依赖。
+ */
+interface AMapNamespace {
+    Map: any;
+    Geocoder: any;
+    AutoComplete: any;
+    PlaceSearch: any;
+    Geolocation: any;
+    LngLat: any;
+    Pixel: any;
+    [key: string]: any;
+}
+interface AMapLoaderLike {
+    load(opts: {
+        key: string;
+        version?: string;
+        plugins?: string[];
+    }): Promise<AMapNamespace>;
+}
+declare global {
+    interface Window {
+        AMapLoader?: AMapLoaderLike;
+        _AMapSecurityConfig?: {
+            securityJsCode?: string;
+            serviceHost?: string;
+        };
+    }
+}
+export interface LoadAMapOptions {
+    key: string;
+    securityJsCode?: string;
+    version?: string;
+    plugins?: string[];
+}
+export declare function loadAMap(opts: LoadAMapOptions): Promise<AMapNamespace>;
+export type { AMapNamespace };

package/build/MapLocationSelection/loader.amap.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * 高德地图 SDK 动态加载器
+ *
+ * 设计目标：
+ *   - clxx 库被静态 import 时绝不携带高德地图 SDK；
+ *   - 只有用户真正使用 MapLocationSelection 时才通过运行时 import 触发拉取；
+ *   - 同一密钥在同一个页面只加载一次，多次调用复用同一个 Promise。
+ *
+ * 实现方式：
+ *   通过动态 `import` 一个由 Blob URL 包装的远程脚本（loader.js），
+ *   等价于在页面里插入 `<script src="https://webapi.amap.com/loader.js"></script>`。
+ *   这样既满足“动态 import”的语义（不会进入 clxx 的静态依赖图），
+ *   又避免了对 `@amap/amap-jsapi-loader` npm 包的硬依赖。
+ */
+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.loadAMap = loadAMap;
+const LOADER_URL = "https://webapi.amap.com/loader.js";
+let scriptPromise = null;
+/**
+ * Chrome 对「2D Canvas 上反复 getImageData」会告警，建议在 getContext('2d') 时传入
+ * `{ willReadFrequently: true }`。高德 JSAPI 2.x 内部地图/定位插件未带该属性，控制台会刷
+ * “Canvas2D: Multiple readback operations...”——功能无碍，但干扰调试。
+ *
+ * 在首次拉取高德脚本**之前**打一次原型补丁，合并 willReadFrequently；全页只对 2d 上下文生效，
+ * 与 HTML 标准对该 hint 的语义一致（读回频繁时更应设为 true）。
+ */
+let didPatchCanvasGetContext = false;
+function patchCanvasGetContextForAMapHint() {
+    if (didPatchCanvasGetContext)
+        return;
+    if (typeof HTMLCanvasElement === "undefined")
+        return;
+    didPatchCanvasGetContext = true;
+    const proto = HTMLCanvasElement.prototype;
+    const orig = proto.getContext;
+    function patchedGetContext(type, contextAttributes) {
+        if (type === "2d") {
+            const base = contextAttributes && typeof contextAttributes === "object"
+                ? Object.assign({}, contextAttributes) : {};
+            base.willReadFrequently = true;
+            return orig.call(this, "2d", base);
+        }
+        return orig.call(this, type, contextAttributes);
+    }
+    // 包装后无法同时满足 lib.dom 对 getContext 的全部重载签名，运行期委托给原生实现即可。
+    proto.getContext = patchedGetContext;
+}
+function ensureLoaderScript() {
+    if (typeof window === "undefined") {
+        return Promise.reject(new Error("AMap loader requires a browser env"));
+    }
+    if (window.AMapLoader)
+        return Promise.resolve(window.AMapLoader);
+    if (scriptPromise)
+        return scriptPromise;
+    scriptPromise = new Promise((resolve, reject) => {
+        // 复用已存在的 script 标签（同一文档内多处使用时）
+        const existed = document.querySelector(`script[src="${LOADER_URL}"]`);
+        const onReady = () => {
+            if (window.AMapLoader)
+                resolve(window.AMapLoader);
+            else
+                reject(new Error("AMapLoader not found after loader.js loaded"));
+        };
+        if (existed) {
+            if (window.AMapLoader) {
+                resolve(window.AMapLoader);
+                return;
+            }
+            existed.addEventListener("load", onReady, { once: true });
+            existed.addEventListener("error", () => reject(new Error("Failed to load AMap loader.js")), { once: true });
+            return;
+        }
+        const script = document.createElement("script");
+        script.src = LOADER_URL;
+        script.async = true;
+        script.onload = onReady;
+        script.onerror = () => {
+            scriptPromise = null;
+            reject(new Error("Failed to load AMap loader.js"));
+        };
+        document.head.appendChild(script);
+    });
+    return scriptPromise;
+}
+const namespacePromiseMap = new Map();
+function loadAMap(opts) {
+    const { key, securityJsCode, version = "2.0", plugins = [
+        "AMap.Geocoder",
+        "AMap.AutoComplete",
+        "AMap.PlaceSearch",
+        "AMap.Geolocation",
+    ], } = opts;
+    // 不同的 key 视为不同实例缓存（同一 key 下复用）
+    const cacheKey = `${key}::${version}::${plugins.join(",")}`;
+    const cached = namespacePromiseMap.get(cacheKey);
+    if (cached)
+        return cached;
+    const promise = (() => __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        patchCanvasGetContextForAMapHint();
+        if (securityJsCode) {
+            // 必须在 loader.load 之前注入
+            window._AMapSecurityConfig = Object.assign(Object.assign({}, ((_a = window._AMapSecurityConfig) !== null && _a !== void 0 ? _a : {})), { securityJsCode });
+        }
+        const loader = yield ensureLoaderScript();
+        return loader.load({ key, version, plugins });
+    }))().catch((err) => {
+        // 失败后允许下次重试
+        namespacePromiseMap.delete(cacheKey);
+        throw err;
+    });
+    namespacePromiseMap.set(cacheKey, promise);
+    return promise;
+}

package/build/MapLocationSelection/loader.bmap.d.ts

@@ -0,0 +1,8 @@
+declare global {
+    interface Window {
+        BMapGL?: any;
+    }
+}
+export declare function loadBMap(opts: {
+    ak: string;
+}): Promise<any>;

package/build/MapLocationSelection/loader.bmap.js

@@ -0,0 +1,60 @@
+"use strict";
+// 百度地图 BMapGL SDK 动态加载器。
+//
+// 设计目标：
+//   - clxx 库被静态 import 时绝不携带百度地图 SDK；
+//   - 只有用户真正使用 MapLocationSelection 且选择 provider="bmap" 时才注入 <script>；
+//   - 同一 ak 在同一个页面只加载一次，多次调用复用同一个 Promise；
+//   - SDK 加载完成的判定靠 `callback` 查询参数（百度官方支持），脚本执行完会调用我们
+//     注入的全局函数，避免使用 onload 但 BMapGL 还未挂载的竞态。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBMap = loadBMap;
+const SCRIPT_URL_BASE = "https://api.map.baidu.com/api?v=1.0&type=webgl&ak=";
+const cachedPromiseMap = new Map();
+function loadBMap(opts) {
+    const { ak } = opts;
+    if (!ak) {
+        return Promise.reject(new Error("BMap ak is required"));
+    }
+    if (typeof window === "undefined") {
+        return Promise.reject(new Error("BMap loader requires a browser env"));
+    }
+    // 已有完整加载的 BMapGL，直接返回
+    if (window.BMapGL) {
+        const ready = Promise.resolve(window.BMapGL);
+        cachedPromiseMap.set(ak, ready);
+        return ready;
+    }
+    const cached = cachedPromiseMap.get(ak);
+    if (cached)
+        return cached;
+    const cbName = `__clxxBMapInit_${Date.now()}_${Math.random()
+        .toString(36)
+        .slice(2)}`;
+    const promise = new Promise((resolve, reject) => {
+        window[cbName] = () => {
+            delete window[cbName];
+            if (window.BMapGL) {
+                resolve(window.BMapGL);
+            }
+            else {
+                // 极端情况：脚本回调被触发但 BMapGL 仍未挂载（一般是 ak 错误的兜底）
+                reject(new Error("BMapGL not available after script callback"));
+            }
+        };
+        const script = document.createElement("script");
+        script.src = `${SCRIPT_URL_BASE}${encodeURIComponent(ak)}&callback=${cbName}`;
+        script.async = true;
+        script.onerror = () => {
+            delete window[cbName];
+            cachedPromiseMap.delete(ak);
+            reject(new Error("Failed to load BMapGL SDK"));
+        };
+        document.head.appendChild(script);
+    }).catch((err) => {
+        cachedPromiseMap.delete(ak);
+        throw err;
+    });
+    cachedPromiseMap.set(ak, promise);
+    return promise;
+}

package/build/MapLocationSelection/provider.amap.d.ts

@@ -0,0 +1,38 @@
+import { type Coord, type POIItem } from "./types";
+import { type GeolocateOptions, type MapProvider, type MapProviderInitOptions, type SearchAroundResult, type SearchOptions, type ReverseGeocodeResult } from "./provider";
+export interface AMapProviderOptions {
+    amapKey: string;
+    securityJsCode?: string;
+}
+export declare class AMapProvider implements MapProvider {
+    private opts;
+    private AMap;
+    private map;
+    private placeSearch;
+    private keywordPlaceSearchNear;
+    private keywordPlaceSearchFull;
+    private geocoder;
+    private geolocation;
+    private userMarker;
+    private pendingGeolocate;
+    private aroundSeq;
+    private keywordSeq;
+    private flying;
+    private flyToTimers;
+    constructor(opts: AMapProviderOptions);
+    private initServices;
+    init(o: MapProviderInitOptions): Promise<void>;
+    initHeadless(opts?: Pick<MapProviderInitOptions, "initialCity">): Promise<void>;
+    destroy(): void;
+    getCenter(): Coord;
+    setCenter(center: Coord, zoom?: number): void;
+    private flyTo;
+    upsertUserMarker(center: Coord): void;
+    searchAround(center: Coord, options: SearchOptions): Promise<SearchAroundResult>;
+    searchByKeyword(center: Coord, keyword: string, options: SearchOptions): Promise<POIItem[]>;
+    geolocate(options?: GeolocateOptions): Promise<Coord | null>;
+    reverseGeocode(center: Coord): Promise<ReverseGeocodeResult | null>;
+    on(event: "movestart", handler: () => void): void;
+    on(event: "moveend", handler: () => void): void;
+    on(event: "click", handler: (lng: number, lat: number) => void): void;
+}