@ywbgn/bgl-package 1.1.1 → 1.2.1

package/dist/index.d.ts

@@ -212,6 +212,14 @@ visible: boolean;
 }> | null;
 }, HTMLDivElement>;
 
+declare const __VLS_component_2: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+close: () => any;
+}, string, PublicProps, Readonly<__VLS_Props_4> & Readonly<{
+onClose?: (() => any) | undefined;
+}>, {
+anchor: "center" | "start";
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
 /** 外层容器尺寸，支持像素数字或 CSS 字符串（如 100%、70vh） */
 declare type __VLS_Props = {
     width?: string | number;
@@ -282,6 +290,53 @@ declare type __VLS_Props_3 = {
     numericLabelColor?: string;
 };
 
+declare type __VLS_Props_4 = {
+    /** 弹框标题 */
+    title: string;
+    /** 弹框宽度，默认 300px */
+    width?: number | string;
+    /**
+     * 水平锚点：center 配合工具栏居中弹框；
+     * start 配合左对齐弹框（如底图切换），拖动不带 -50% 偏移。
+     */
+    anchor?: 'center' | 'start';
+};
+
+declare type __VLS_Props_5 = {
+    map: default_2 | null;
+    view: default_3 | null;
+    systemCoordinateWkid?: number | null;
+    mapBounds?: MapBounds | null;
+};
+
+declare type __VLS_Props_6 = {
+    /** 双向绑定值 */
+    modelValue?: string | number;
+    /** 输入类型 */
+    type?: string;
+    /** 占位文案 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 原生最小值 */
+    min?: string | number;
+    /** 原生最大值 */
+    max?: string | number;
+};
+
+declare type __VLS_Props_7 = {
+    /** 当前值 */
+    modelValue?: string;
+    /** 选项列表 */
+    options?: BglSelectOption[];
+    /** 无选中值时的占位文案 */
+    placeholder?: string;
+    /** 是否展开 */
+    open?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+};
+
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -329,14 +384,31 @@ declare function __VLS_template(): {
     rootEl: HTMLDivElement;
 };
 
+declare function __VLS_template_2(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+
 declare type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 
+declare type __VLS_TemplateResult_2 = ReturnType<typeof __VLS_template_2>;
+
 declare type __VLS_WithTemplateSlots<T, S> = T & {
     new (): {
         $slots: S;
     };
 };
 
+declare type __VLS_WithTemplateSlots_2<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
 /**
  * 按配置给已上图的业务 FeatureLayer 设置 labelingInfo。
  * 仅 FeatureLayer 生效；找不到图层时跳过。
@@ -426,6 +498,44 @@ keys: BasemapKeys | null;
 basemapSelectRef: HTMLDivElement;
 }, HTMLDivElement>;
 
+export declare const BglInput: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:modelValue": (value: string) => any;
+}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+type: string;
+placeholder: string;
+disabled: boolean;
+modelValue: string | number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+export declare const BglSelect: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+select: (value: string) => any;
+"update:modelValue": (value: string) => any;
+"update:open": (open: boolean) => any;
+}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{
+onSelect?: ((value: string) => any) | undefined;
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+"onUpdate:open"?: ((open: boolean) => any) | undefined;
+}>, {
+placeholder: string;
+disabled: boolean;
+modelValue: string;
+options: BglSelectOption[];
+open: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+rootRef: HTMLDivElement;
+}, any>;
+
+declare type BglSelectOption = {
+    /** 选项值 */
+    value: string;
+    /** 选项展示文案 */
+    label: string;
+    /** 是否禁用该选项 */
+    disabled?: boolean;
+};
+
 /**
  * 由字段列表生成 Arcade 表达式（空格拼接）。
  */
@@ -560,6 +670,11 @@ export declare const getSpatialReferenceMismatches: () => SpatialReferenceMismat
  */
 export declare const goToFullExtent: (view: default_3, lonLatExtent: LonLatExtent) => Promise<void>;
 
+/**
+ * 判断 goTo 是否被后续定位打断（可安全忽略，避免 Uncaught (in promise)）。
+ */
+export declare const isViewGotoInterrupted: (error: unknown) => boolean;
+
 declare type LayerProps = __esri.FeatureLayerProperties | __esri.MapImageLayerProperties;
 
 /** 图例停靠左右（避让业务侧栏） */
@@ -621,6 +736,13 @@ export declare type LonLatExtent = {
     ymax: number;
 };
 
+export declare type MapBounds = {
+    jwXMin: number;
+    jwXMax: number;
+    jwYMin: number;
+    jwYMax: number;
+};
+
 export declare const MapLegend: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{}>, {
 idPrefix: string;
 position: LegendDockPosition;
@@ -646,11 +768,13 @@ barStyle: ScaleBarStyle;
 showNumericScale: boolean;
 numericScaleUseGrouping: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {
-scaleBarContainerRef: HTMLDivElement;
+rootRef: HTMLDivElement;
 }, HTMLDivElement>;
 
 export declare const MapToolbar: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 
+export declare const MapToolPanel: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
+
 /**
  * 将待创建图层真正加入地图并重排 z 序。
  * 成功后从登记表移除；失败返回 null。
@@ -660,6 +784,12 @@ export declare const materializePendingBusinessLayer: (map: default_2, layerId:
 /** 合并注记所需 outFields（默认注记与手动标注共用） */
 export declare const mergeOutFields: (layer: default_7, fields: string[]) => void;
 
+/**
+ * 将 FeatureLayer 服务自带 labelingInfo 中的不可用字体改为 Web 安全字体，
+ * 避免 GET .../fonts/simsun-regular/*.pbf 404。
+ */
+export declare const normalizeFeatureLayerLabelFonts: (layer: default_7) => void;
+
 /** 去空白并大写，便于 WKT 文本比较 */
 export declare const normalizeWkt: (wkt: string) => string;
 
@@ -671,6 +801,10 @@ export declare type PanConstraintHandle = {
     remove(): void;
     /** 包装 view.goTo，程序化定位期间临时放开边界约束 */
     wrapViewGoTo(view: default_3): void;
+    /** 长期暂停约束（如 TXT 画图面板打开） */
+    suspend(): void;
+    /** 恢复约束 */
+    resume(): void;
 };
 
 /** 待创建业务图层的创建参数（勾选显示时使用） */
@@ -696,6 +830,16 @@ export declare type PendingBusinessLayerItem = {
 declare const plugin: Plugin_2;
 export default plugin;
 
+/** 后端代签 token 登记选项（不含账号密码） */
+export declare type PortalAccessTokenOptions = {
+    /** Portal 根地址，如 https://map.baigeli.cn */
+    portalUrl: string;
+    /** 已签发的 Portal access token */
+    token: string;
+    /** 额外登记的 server 根路径（图层 host 与 portal 不一致时传入） */
+    extraServers?: string[];
+};
+
 export declare type PortalAuthOptions = {
     /** Portal 根地址，如 https://map.baigeli.cn */
     portalUrl: string;
@@ -714,6 +858,25 @@ export declare type PortalAuthOptions = {
     referer?: string;
 };
 
+/** 通过 fetchToken 回调续期的选项（生产推荐） */
+export declare type PortalTokenFetcherRenewalOptions = {
+    portalUrl: string;
+    /** 首次与续期均调用；返回 null 表示跳过鉴权 */
+    fetchToken: () => Promise<PortalTokenFetchResult | string | null>;
+    /** fetch 未返回 expires 时的有效分钟数，默认 60 */
+    expirationMinutes?: number;
+    renewBeforeMinutes?: number;
+    extraServers?: string[];
+    onRenewError?: (error: unknown) => void;
+};
+
+/** 后端代签 fetch 返回值 */
+export declare type PortalTokenFetchResult = {
+    token: string;
+    /** 过期时间戳（毫秒）；有则按此调度续期 */
+    expires?: number;
+};
+
 /** startPortalTokenRenewal 的返回值 */
 export declare type PortalTokenRenewalHandle = {
     /** 当前已登记的 token */
@@ -729,7 +892,10 @@ export declare type PortalTokenRenewalOptions = PortalAuthOptions & {
      * 例：120 分钟有效 → 默认约提前 20 分钟续期。
      */
     renewBeforeMinutes?: number;
-    /** 续期失败回调（定时刷新失败时）；首次注册失败仍会抛错 */
+    /**
+     * 续期失败回调（定时刷新失败时）；首次注册失败仍会抛错。
+     * 连续失败时库内会节流：首次立即回调，之后同一失败串最多约每 15 分钟回调一次。
+     */
     onRenewError?: (error: unknown) => void;
 };
 
@@ -739,6 +905,11 @@ export declare type PortalTokenRenewalOptions = PortalAuthOptions & {
  */
 export declare const provideBasemapKeys: (keys: MaybeRef<BasemapKeys>) => void;
 
+/**
+ * 登记后端代签的 Portal token（不调用 generateToken）。
+ */
+export declare const registerPortalAccessToken: (options: PortalAccessTokenOptions) => string;
+
 /**
  * 向 IdentityManager 注册 Portal token，并挂请求拦截器保证首轮带 token。
  * 注意：前端持有账号密码仅适合内网联调；生产应由后端签发 token。
@@ -770,6 +941,14 @@ export declare const resolveLabelExpression: (config: BusinessLayerLabelConfig)
  */
 export declare const resolveLayerVisible: (value: unknown) => boolean;
 
+/** 恢复指定视图的平移边界约束 */
+export declare function resumePanBounds(view: default_3): void;
+
+/**
+ * 包装 view.goTo：忽略打断类拒绝，其它错误继续抛出。
+ */
+export declare const safeViewGoTo: (view: default_3, target: Parameters<default_3["goTo"]>[0], options?: Parameters<default_3["goTo"]>[1]) => Promise<void>;
+
 /** 比例尺样式 */
 declare type ScaleBarStyle = 'line' | 'ruler';
 
@@ -785,6 +964,16 @@ export declare const setPendingBusinessLayers: (layers: BusinessLayerConfig[], o
 /** 是否应按 MapImageLayer 加载（整幅 MapServer） */
 export declare const shouldUseMapImageLayer: (item: BusinessLayerConfig) => boolean;
 
+export declare const SpatialAnalysisPanel: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{}>, {
+systemCoordinateWkid: number | null;
+mapBounds: MapBounds | null;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+fileInputRef: HTMLInputElement;
+tabsScrollRef: HTMLDivElement;
+tableWrapRef: HTMLDivElement;
+wordRef: HTMLDivElement;
+}, HTMLDivElement>;
+
 /** 业务图层坐标系校验结果原因 */
 export declare type SpatialReferenceCheckReason = 'mismatch' | 'unreadable';
 
@@ -824,12 +1013,21 @@ export declare type SpatialReferenceMismatchInfo = {
  */
 export declare const startPortalTokenRenewal: (options: PortalTokenRenewalOptions) => Promise<PortalTokenRenewalHandle>;
 
+/**
+ * 通过 fetchToken 登记 Portal token 并自动续期（后端代签场景）。
+ * fetchToken 应调用业务后端 /portalToken，不再持有 Portal 账号密码。
+ */
+export declare const startPortalTokenRenewalWithFetcher: (options: PortalTokenFetcherRenewalOptions) => Promise<PortalTokenRenewalHandle>;
+
 /** 订阅待创建列表变化（返回取消订阅） */
 export declare const subscribePendingBusinessLayers: (listener: () => void) => (() => void);
 
 /** 订阅不一致登记变化（返回取消订阅函数） */
 export declare const subscribeSpatialReferenceMismatches: (listener: () => void) => (() => void);
 
+/** 暂停指定视图的平移边界约束 */
+export declare function suspendPanBounds(view: default_3): void;
+
 export declare const SwipeCompare: DefineComponent<ExtractPropTypes<    {
 /** MapView 实例 */
 view: {
@@ -879,7 +1077,7 @@ export declare const toFeatureLayerProps: (item: BusinessLayerConfig) => __esri.
 export declare const toLayerProps: (item: BusinessLayerConfig, options?: Pick<LoadBusinessLayersOptions, "idPrefix" | "outFields" | "accessToken">) => LayerProps;
 
 /** 工具栏内置工具 id（不含坐标条，坐标条由 showCoordinate 控制） */
-export declare type ToolbarToolId = 'fullExtent' | 'fullscreen' | 'zoomIn' | 'zoomOut' | 'coordinateLocate' | 'distanceMeasure' | 'areaMeasure' | 'layerManage' | 'layerSwipe' | 'mapLabel' | 'conditionQuery';
+export declare type ToolbarToolId = 'fullExtent' | 'fullscreen' | 'zoomIn' | 'zoomOut' | 'prevExtent' | 'nextExtent' | 'coordinateLocate' | 'distanceMeasure' | 'areaMeasure' | 'layerManage' | 'layerSwipe' | 'mapLabel' | 'conditionQuery' | 'txtDraw';
 
 /**
  * 解析底图密钥：显式 props.keys 优先，否则取 inject，再否则空对象。
@@ -887,4 +1085,7 @@ export declare type ToolbarToolId = 'fullExtent' | 'fullscreen' | 'zoomIn' | 'zo
  */
 export declare const useBasemapKeys: (propsKeys?: MaybeRefOrGetter<BasemapKeys | null | undefined>) => ComputedRef<BasemapKeys>;
 
+/** 地图 Web 标注可用字体（Esri CDN 托管字形） */
+export declare const WEB_SAFE_LABEL_FONT = "Arial Unicode MS";
+
 export { }