@ywbgn/bgl-package 1.1.1 → 1.2.2

package/dist/index.d.ts

@@ -1,7 +1,15 @@
+import { AllowedComponentProps } from 'vue';
+import { Attrs } from 'vue';
+import { ComponentCustomProperties } from 'vue';
+import { ComponentCustomProps } from 'vue';
+import { ComponentInternalInstance } from 'vue';
+import { ComponentOptionsBase } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
+import { ComponentPublicInstance } from 'vue';
 import { ComputedRef } from 'vue';
 import { CreateComponentPublicInstanceWithMixins } from 'vue';
+import { DebuggerEvent } from 'vue';
 import { default as default_2 } from '@arcgis/core/Map.js';
 import { default as default_3 } from '@arcgis/core/views/MapView.js';
 import { default as default_4 } from '@arcgis/core/layers/GraphicsLayer.js';
@@ -15,9 +23,15 @@ import { GlobalDirectives } from 'vue';
 import { InjectionKey } from 'vue';
 import { MaybeRef } from 'vue';
 import { MaybeRefOrGetter } from 'vue';
+import { nextTick } from 'vue';
+import { OnCleanup } from '@vue/reactivity';
 import { Plugin as Plugin_2 } from 'vue';
 import { PropType } from 'vue';
 import { PublicProps } from 'vue';
+import { Slot } from 'vue';
+import { VNodeProps } from 'vue';
+import { WatchOptions } from 'vue';
+import { WatchStopHandle } from 'vue';
 
 declare const __VLS_component: DefineComponent<ExtractPropTypes<    {
 /** MapView 实例 */
@@ -212,6 +226,33 @@ visible: boolean;
 }> | null;
 }, HTMLDivElement>;
 
+declare const __VLS_component_2: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+close: () => any;
+}, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{
+onClose?: (() => any) | undefined;
+}>, {
+anchor: "center" | "start";
+appearance: LegendAppearance;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+declare const __VLS_component_3: DefineComponent<__VLS_Props_9, {
+scrollToTop: typeof scrollToTop;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:activeIndex": (index: number) => any;
+}, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{
+"onUpdate:activeIndex"?: ((index: number) => any) | undefined;
+}>, {
+rows: BglDataTableRow[];
+columns: BglDataTableColumn[];
+align: "left" | "center";
+activeIndex: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+headRef: HTMLDivElement;
+headTableRef: HTMLTableElement;
+wrapRef: HTMLDivElement;
+bodyTableRef: HTMLTableElement;
+}, HTMLDivElement>;
+
 /** 外层容器尺寸，支持像素数字或 CSS 字符串（如 100%、70vh） */
 declare type __VLS_Props = {
     width?: string | number;
@@ -233,6 +274,17 @@ declare type __VLS_Props = {
 };
 
 declare type __VLS_Props_2 = {
+    /** MapView 实例 */
+    view: default_3;
+    /** 业务图层 id 前缀，与 loadBusinessLayers 一致 */
+    idPrefix?: string;
+    /**
+     * 弹框外观。plain=纯色圆角面板；frame=切图九宫格背景。
+     */
+    appearance?: LegendAppearance;
+};
+
+declare type __VLS_Props_3 = {
     /** MapView 实例 */
     view: default_3;
     /** 业务图层 id 前缀，与 loadBusinessLayers 一致 */
@@ -249,9 +301,13 @@ declare type __VLS_Props_2 = {
      * 默认 14，停靠左下、位于底图/卷帘入口下方；底图/卷帘默认 bottom 已上移避开图例高度。
      */
     offsetY?: number;
+    /**
+     * 图例外观。plain=现有纯色圆角面板；frame=切图九宫格背景。
+     */
+    appearance?: LegendAppearance;
 };
 
-declare type __VLS_Props_3 = {
+declare type __VLS_Props_4 = {
     /** MapView 实例 */
     view: default_3;
     /**
@@ -282,6 +338,68 @@ declare type __VLS_Props_3 = {
     numericLabelColor?: string;
 };
 
+declare type __VLS_Props_5 = {
+    /** 弹框标题 */
+    title: string;
+    /** 弹框宽度，默认 300px */
+    width?: number | string;
+    /**
+     * 水平锚点：center 配合工具栏居中弹框；
+     * start 配合左对齐弹框（如底图切换），拖动不带 -50% 偏移。
+     */
+    anchor?: 'center' | 'start';
+    /**
+     * 弹框外观。plain=纯色圆角面板；frame=切图九宫格背景。
+     */
+    appearance?: LegendAppearance;
+};
+
+declare type __VLS_Props_6 = {
+    map: default_2 | null;
+    view: default_3 | null;
+    systemCoordinateWkid?: number | null;
+    mapBounds?: MapBounds | null;
+};
+
+declare type __VLS_Props_7 = {
+    /** 双向绑定值 */
+    modelValue?: string | number;
+    /** 输入类型 */
+    type?: string;
+    /** 占位文案 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 原生最小值 */
+    min?: string | number;
+    /** 原生最大值 */
+    max?: string | number;
+};
+
+declare type __VLS_Props_8 = {
+    /** 当前值 */
+    modelValue?: string;
+    /** 选项列表 */
+    options?: BglSelectOption[];
+    /** 无选中值时的占位文案 */
+    placeholder?: string;
+    /** 是否展开 */
+    open?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+};
+
+declare type __VLS_Props_9 = {
+    /** 列定义 */
+    columns?: BglDataTableColumn[];
+    /** 行数据 */
+    rows?: BglDataTableRow[];
+    /** 单元格对齐方式 */
+    align?: 'left' | 'center';
+    /** 当前高亮行下标，-1 表示无 */
+    activeIndex?: number;
+};
+
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -329,14 +447,58 @@ declare function __VLS_template(): {
     rootEl: HTMLDivElement;
 };
 
+declare function __VLS_template_2(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+
+declare function __VLS_template_3(): {
+    attrs: Partial<{}>;
+    slots: Partial<Record<`cell-${string}`, (_: {
+        row: BglDataTableRow;
+        index: number;
+        column: BglDataTableColumn;
+        value: string | number;
+    }) => any>> & {
+        footer?(_: {}): any;
+    };
+    refs: {
+        headRef: HTMLDivElement;
+        headTableRef: HTMLTableElement;
+        wrapRef: HTMLDivElement;
+        bodyTableRef: HTMLTableElement;
+    };
+    rootEl: HTMLDivElement;
+};
+
 declare type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 
+declare type __VLS_TemplateResult_2 = ReturnType<typeof __VLS_template_2>;
+
+declare type __VLS_TemplateResult_3 = ReturnType<typeof __VLS_template_3>;
+
 declare type __VLS_WithTemplateSlots<T, S> = T & {
     new (): {
         $slots: S;
     };
 };
 
+declare type __VLS_WithTemplateSlots_2<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+declare type __VLS_WithTemplateSlots_3<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
 /**
  * 按配置给已上图的业务 FeatureLayer 设置 labelingInfo。
  * 仅 FeatureLayer 生效；找不到图层时跳过。
@@ -405,6 +567,13 @@ keys: {
 type: PropType<BasemapKeys | null>;
 default: null;
 };
+/**
+* 弹框外观。plain=纯色圆角面板；frame=切图九宫格背景。
+*/
+appearance: {
+type: PropType<LegendAppearance>;
+default: string;
+};
 }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "before-change": () => any;
 }, string, PublicProps, Readonly<ExtractPropTypes<    {
@@ -418,14 +587,80 @@ keys: {
 type: PropType<BasemapKeys | null>;
 default: null;
 };
+/**
+* 弹框外观。plain=纯色圆角面板；frame=切图九宫格背景。
+*/
+appearance: {
+type: PropType<LegendAppearance>;
+default: string;
+};
 }>> & Readonly<{
 "onBefore-change"?: (() => any) | undefined;
 }>, {
 keys: BasemapKeys | null;
+appearance: LegendAppearance;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {
 basemapSelectRef: HTMLDivElement;
 }, HTMLDivElement>;
 
+export declare const BglDataTable: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
+
+/** 表格列 */
+export declare type BglDataTableColumn = {
+    /** 表头文案 */
+    title: string;
+    /** 列标识，同时作为单元格插槽名 cell-<key> */
+    key: string;
+    /** 列宽，如 '48px' */
+    width?: string;
+    /** 单元格渲染，缺省时按 key 直接取值 */
+    render?: (row: BglDataTableRow, index: number) => string | number;
+};
+
+/**
+ * 通用数据表格类型定义
+ */
+/** 表格行 */
+export declare type BglDataTableRow = Record<string, string | number | undefined>;
+
+export declare const BglInput: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:modelValue": (value: string) => any;
+}, string, PublicProps, Readonly<__VLS_Props_7> & 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_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+select: (value: string) => any;
+"update:modelValue": (value: string) => any;
+"update:open": (open: boolean) => any;
+}, string, PublicProps, Readonly<__VLS_Props_8> & 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,8 +795,23 @@ 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;
 
+export declare const LayerSwitch: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{}>, {
+appearance: LegendAppearance;
+idPrefix: string;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+rootRef: HTMLDivElement;
+}, HTMLDivElement>;
+
+/** 图例外观：plain=纯色圆角面板；frame=切图九宫格背景 */
+export declare type LegendAppearance = 'plain' | 'frame';
+
 /** 图例停靠左右（避让业务侧栏） */
 export declare type LegendDockPosition = 'left' | 'right';
 
@@ -621,7 +871,15 @@ export declare type LonLatExtent = {
     ymax: number;
 };
 
-export declare const MapLegend: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{}>, {
+export declare type MapBounds = {
+    jwXMin: number;
+    jwXMax: number;
+    jwYMin: number;
+    jwYMax: number;
+};
+
+export declare const MapLegend: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{}>, {
+appearance: LegendAppearance;
 idPrefix: string;
 position: LegendDockPosition;
 offsetX: number;
@@ -637,7 +895,7 @@ export declare interface MapReadyPayload {
     sketchLayer: default_4;
 }
 
-export declare const MapScaleBar: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{}>, {
+export declare const MapScaleBar: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_4> & Readonly<{}>, {
 position: LegendDockPosition;
 offsetX: number;
 offsetY: number;
@@ -646,11 +904,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 +920,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 +937,10 @@ export declare type PanConstraintHandle = {
     remove(): void;
     /** 包装 view.goTo，程序化定位期间临时放开边界约束 */
     wrapViewGoTo(view: default_3): void;
+    /** 长期暂停约束（如 TXT 画图面板打开） */
+    suspend(): void;
+    /** 恢复约束 */
+    resume(): void;
 };
 
 /** 待创建业务图层的创建参数（勾选显示时使用） */
@@ -696,6 +966,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 +994,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 +1028,10 @@ export declare type PortalTokenRenewalOptions = PortalAuthOptions & {
      * 例：120 分钟有效 → 默认约提前 20 分钟续期。
      */
     renewBeforeMinutes?: number;
-    /** 续期失败回调（定时刷新失败时）；首次注册失败仍会抛错 */
+    /**
+     * 续期失败回调（定时刷新失败时）；首次注册失败仍会抛错。
+     * 连续失败时库内会节流：首次立即回调，之后同一失败串最多约每 15 分钟回调一次。
+     */
     onRenewError?: (error: unknown) => void;
 };
 
@@ -739,6 +1041,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,12 +1077,23 @@ 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';
 
 /** 比例尺单位 */
 declare type ScaleBarUnit = 'metric' | 'imperial' | 'dual';
 
+/** 滚动重置到左上角（切换 Tab 等场景使用） */
+declare function scrollToTop(): void;
+
 /**
  * 登记尚未上图的业务图层（默认隐藏）。
  * 不 map.add，因此不会触发服务元数据请求；用户勾选时再 materialize。
@@ -785,6 +1103,126 @@ export declare const setPendingBusinessLayers: (layers: BusinessLayerConfig[], o
 /** 是否应按 MapImageLayer 加载（整幅 MapServer） */
 export declare const shouldUseMapImageLayer: (item: BusinessLayerConfig) => boolean;
 
+export declare const SpatialAnalysisPanel: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{}>, {
+systemCoordinateWkid: number | null;
+mapBounds: MapBounds | null;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+fileInputRef: HTMLInputElement;
+tabsScrollRef: HTMLDivElement;
+resultTableRef: ({
+$: ComponentInternalInstance;
+$data: {};
+$props: {
+readonly columns?: BglDataTableColumn[] | undefined;
+readonly rows?: BglDataTableRow[] | undefined;
+readonly align?: "left" | "center" | undefined;
+readonly activeIndex?: number | undefined;
+readonly "onUpdate:activeIndex"?: ((index: number) => any) | undefined;
+} & VNodeProps & AllowedComponentProps & ComponentCustomProps;
+$attrs: Attrs;
+$refs: {
+[x: string]: unknown;
+} & {
+headRef: HTMLDivElement;
+headTableRef: HTMLTableElement;
+wrapRef: HTMLDivElement;
+bodyTableRef: HTMLTableElement;
+};
+$slots: Readonly<{
+[name: string]: Slot<any> | undefined;
+}>;
+$root: ComponentPublicInstance | null;
+$parent: ComponentPublicInstance | null;
+$host: Element | null;
+$emit: (event: "update:activeIndex", index: number) => void;
+$el: HTMLDivElement;
+$options: ComponentOptionsBase<Readonly<{
+columns?: BglDataTableColumn[];
+rows?: BglDataTableRow[];
+align?: "left" | "center";
+activeIndex?: number;
+}> & Readonly<{
+"onUpdate:activeIndex"?: ((index: number) => any) | undefined;
+}>, {
+scrollToTop: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:activeIndex": (index: number) => any;
+}, string, {
+rows: BglDataTableRow[];
+columns: BglDataTableColumn[];
+align: "left" | "center";
+activeIndex: number;
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
+beforeCreate?: (() => void) | (() => void)[];
+created?: (() => void) | (() => void)[];
+beforeMount?: (() => void) | (() => void)[];
+mounted?: (() => void) | (() => void)[];
+beforeUpdate?: (() => void) | (() => void)[];
+updated?: (() => void) | (() => void)[];
+activated?: (() => void) | (() => void)[];
+deactivated?: (() => void) | (() => void)[];
+beforeDestroy?: (() => void) | (() => void)[];
+beforeUnmount?: (() => void) | (() => void)[];
+destroyed?: (() => void) | (() => void)[];
+unmounted?: (() => void) | (() => void)[];
+renderTracked?: ((e: DebuggerEvent) => void) | ((e: DebuggerEvent) => void)[];
+renderTriggered?: ((e: DebuggerEvent) => void) | ((e: DebuggerEvent) => void)[];
+errorCaptured?: ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void)[];
+};
+$forceUpdate: () => void;
+$nextTick: typeof nextTick;
+$watch<T extends string | ((
+/**
+* 空间分析面板（可导出地图组件）
+* UI + 业务编排：叠加图层、上传上图、分析、导出、重置
+* map/view 由宿主 props 注入
+*/
+...args: any) => any)>(source: T, cb: T extends (
+/**
+* 空间分析面板（可导出地图组件）
+* UI + 业务编排：叠加图层、上传上图、分析、导出、重置
+* map/view 由宿主 props 注入
+*/
+...args: any) => infer R ? (
+/**
+* 空间分析面板（可导出地图组件）
+* UI + 业务编排：叠加图层、上传上图、分析、导出、重置
+* map/view 由宿主 props 注入
+*/
+...args: [R, R, OnCleanup]) => any : (
+/**
+* 空间分析面板（可导出地图组件）
+* UI + 业务编排：叠加图层、上传上图、分析、导出、重置
+* map/view 由宿主 props 注入
+*/
+...args: [any, any, OnCleanup]) => any, options?: WatchOptions): WatchStopHandle;
+} & Readonly<{
+rows: BglDataTableRow[];
+columns: BglDataTableColumn[];
+align: "left" | "center";
+activeIndex: number;
+}> & Omit<Readonly<{
+columns?: BglDataTableColumn[];
+rows?: BglDataTableRow[];
+align?: "left" | "center";
+activeIndex?: number;
+}> & Readonly<{
+"onUpdate:activeIndex"?: ((index: number) => any) | undefined;
+}>, "scrollToTop" | ("rows" | "columns" | "align" | "activeIndex")> & {
+scrollToTop: () => void;
+} & {} & ComponentCustomProperties & {} & {
+$slots: Partial<Record<`cell-${string}`, (_: {
+row: BglDataTableRow;
+index: number;
+column: BglDataTableColumn;
+value: string | number;
+}) => any>> & {
+footer?(_: {}): any;
+};
+}) | null;
+wordRef: HTMLDivElement;
+}, HTMLDivElement>;
+
 /** 业务图层坐标系校验结果原因 */
 export declare type SpatialReferenceCheckReason = 'mismatch' | 'unreadable';
 
@@ -824,12 +1262,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: {
@@ -841,6 +1288,13 @@ keys: {
 type: PropType<BasemapKeys | null>;
 default: null;
 };
+/**
+* 弹框外观。plain=纯色圆角面板；frame=切图九宫格背景。
+*/
+appearance: {
+type: PropType<LegendAppearance>;
+default: string;
+};
 }>, {
 destroySwipe: () => void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
@@ -854,8 +1308,16 @@ keys: {
 type: PropType<BasemapKeys | null>;
 default: null;
 };
+/**
+* 弹框外观。plain=纯色圆角面板；frame=切图九宫格背景。
+*/
+appearance: {
+type: PropType<LegendAppearance>;
+default: string;
+};
 }>> & Readonly<{}>, {
 keys: BasemapKeys | null;
+appearance: LegendAppearance;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {
 swipeSelectRef: HTMLDivElement;
 }, HTMLDivElement>;
@@ -879,7 +1341,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 +1349,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 { }