@ywbgn/bgl-package 1.0.0 → 1.2.1

package/dist/index.d.ts

@@ -0,0 +1,1091 @@
+import { ComponentOptionsMixin } from 'vue';
+import { ComponentProvideOptions } from 'vue';
+import { ComputedRef } from 'vue';
+import { CreateComponentPublicInstanceWithMixins } 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';
+import { default as default_5 } from '@arcgis/core/layers/Layer.js';
+import { default as default_6 } from '@arcgis/core/layers/support/LabelClass.js';
+import { default as default_7 } from '@arcgis/core/layers/FeatureLayer.js';
+import { DefineComponent } from 'vue';
+import { ExtractPropTypes } from 'vue';
+import { GlobalComponents } from 'vue';
+import { GlobalDirectives } from 'vue';
+import { InjectionKey } from 'vue';
+import { MaybeRef } from 'vue';
+import { MaybeRefOrGetter } from 'vue';
+import { Plugin as Plugin_2 } from 'vue';
+import { PropType } from 'vue';
+import { PublicProps } from 'vue';
+
+declare const __VLS_component: DefineComponent<ExtractPropTypes<    {
+/** MapView 实例 */
+view: {
+type: PropType<default_3>;
+required: true;
+};
+/**
+* 绘图图层（由 ArcgisMap 注入）；测量等工具自建图层，此处保留以兼容既有接入方式。
+*/
+sketchLayer: {
+type: PropType<default_4>;
+required: true;
+};
+/**
+* 图层管理 / 业务卷帘 / 地图标注 / 条件查询识别的业务图层 id 前缀，需与 loadBusinessLayers 的 idPrefix 一致。
+*/
+layerIdPrefix: {
+type: StringConstructor;
+default: string;
+};
+/**
+* 白名单：仅显示这些工具。不传则显示全部（再减去 hiddenTools）。
+*/
+tools: {
+type: PropType<ToolbarToolId[]>;
+default: undefined;
+};
+/**
+* 黑名单：从默认全量中隐藏。与 tools 同时传时以 tools 为准。
+*/
+hiddenTools: {
+type: PropType<ToolbarToolId[]>;
+default: () => never[];
+};
+/** 是否显示底部经纬度条，默认 true */
+showCoordinate: {
+type: BooleanConstructor;
+default: boolean;
+};
+/**
+* 全图定位中心 [经度, 纬度]。传入后点击全图会同时回到该中心与 minZoom。
+* 若同时传入 homeExtent，优先使用 homeExtent（与平移边界一致）。
+*/
+homeCenter: {
+type: PropType<[number, number]>;
+default: undefined;
+};
+/**
+* 全图经纬度范围。传入后点击全图走 goToFullExtent（minZoom + 范围中心）。
+*/
+homeExtent: {
+type: PropType<LonLatExtent | null>;
+default: null;
+};
+/**
+* 为 true 时全图点击只抛 fullExtent，由业务侧自行完成定位。
+*/
+delegateFullExtent: {
+type: BooleanConstructor;
+default: boolean;
+};
+/** 坐标定位面板的动态坐标系配置；不传则走内置默认项 */
+coordinateSystemConfig: {
+type: PropType<CoordinateSystemConfig | null>;
+default: null;
+};
+}>, {
+destroySwipe: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+fullExtent: () => any;
+layerManage: () => any;
+conditionQuery: () => any;
+swipeCompare: () => any;
+}, string, PublicProps, Readonly<ExtractPropTypes<    {
+/** MapView 实例 */
+view: {
+type: PropType<default_3>;
+required: true;
+};
+/**
+* 绘图图层（由 ArcgisMap 注入）；测量等工具自建图层，此处保留以兼容既有接入方式。
+*/
+sketchLayer: {
+type: PropType<default_4>;
+required: true;
+};
+/**
+* 图层管理 / 业务卷帘 / 地图标注 / 条件查询识别的业务图层 id 前缀，需与 loadBusinessLayers 的 idPrefix 一致。
+*/
+layerIdPrefix: {
+type: StringConstructor;
+default: string;
+};
+/**
+* 白名单：仅显示这些工具。不传则显示全部（再减去 hiddenTools）。
+*/
+tools: {
+type: PropType<ToolbarToolId[]>;
+default: undefined;
+};
+/**
+* 黑名单：从默认全量中隐藏。与 tools 同时传时以 tools 为准。
+*/
+hiddenTools: {
+type: PropType<ToolbarToolId[]>;
+default: () => never[];
+};
+/** 是否显示底部经纬度条，默认 true */
+showCoordinate: {
+type: BooleanConstructor;
+default: boolean;
+};
+/**
+* 全图定位中心 [经度, 纬度]。传入后点击全图会同时回到该中心与 minZoom。
+* 若同时传入 homeExtent，优先使用 homeExtent（与平移边界一致）。
+*/
+homeCenter: {
+type: PropType<[number, number]>;
+default: undefined;
+};
+/**
+* 全图经纬度范围。传入后点击全图走 goToFullExtent（minZoom + 范围中心）。
+*/
+homeExtent: {
+type: PropType<LonLatExtent | null>;
+default: null;
+};
+/**
+* 为 true 时全图点击只抛 fullExtent，由业务侧自行完成定位。
+*/
+delegateFullExtent: {
+type: BooleanConstructor;
+default: boolean;
+};
+/** 坐标定位面板的动态坐标系配置；不传则走内置默认项 */
+coordinateSystemConfig: {
+type: PropType<CoordinateSystemConfig | null>;
+default: null;
+};
+}>> & Readonly<{
+onFullExtent?: (() => any) | undefined;
+onLayerManage?: (() => any) | undefined;
+onConditionQuery?: (() => any) | undefined;
+onSwipeCompare?: (() => any) | undefined;
+}>, {
+coordinateSystemConfig: CoordinateSystemConfig | null;
+layerIdPrefix: string;
+tools: ToolbarToolId[];
+hiddenTools: ToolbarToolId[];
+showCoordinate: boolean;
+homeCenter: [number, number];
+homeExtent: LonLatExtent | null;
+delegateFullExtent: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {
+layerSwipeRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+view: default_3;
+visible?: boolean;
+idPrefix?: string;
+}> & Readonly<{
+onClose?: (() => any) | undefined;
+}>, {
+destroySwipe: () => void;
+isSwipeActive: () => boolean;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+close: () => any;
+}, PublicProps, {
+idPrefix: string;
+visible: boolean;
+}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+leftSelectRef: HTMLDivElement;
+rightSelectRef: HTMLDivElement;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{
+view: default_3;
+visible?: boolean;
+idPrefix?: string;
+}> & Readonly<{
+onClose?: (() => any) | undefined;
+}>, {
+destroySwipe: () => void;
+isSwipeActive: () => boolean;
+}, {}, {}, {}, {
+idPrefix: string;
+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;
+    height?: string | number;
+    /** 初始/当前缩放级别，业务侧可绑定变量动态调整 */
+    zoom?: number;
+    /** 初始/当前中心 [经度, 纬度]，与 MapView.center 一致 */
+    center?: [number, number];
+    /** 底图相关密钥；也可由上层 provide(BASEMAP_KEYS_KEY) */
+    keys?: BasemapKeys | null;
+    /** 缩放下限；传入后写入 view.constraints.minZoom */
+    minZoom?: number | null;
+    /** 缩放上限；传入后写入 view.constraints.maxZoom */
+    maxZoom?: number | null;
+    /**
+     * 经纬度平移边界（WGS84）。传入后自动限制拖动，并在程序化 goTo 期间临时放开约束。
+     */
+    panBounds?: LonLatExtent | null;
+};
+
+declare type __VLS_Props_2 = {
+    /** MapView 实例 */
+    view: default_3;
+    /** 业务图层 id 前缀，与 loadBusinessLayers 一致 */
+    idPrefix?: string;
+    /**
+     * 停靠左右。右侧有业务抽屉（如空间分析）时用 left；
+     * 左侧有面板时用 right。
+     */
+    position?: LegendDockPosition;
+    /** 水平边距（px） */
+    offsetX?: number;
+    /**
+     * 相对地图底边抬高（px）。
+     * 默认 14，停靠左下、位于底图/卷帘入口下方；底图/卷帘默认 bottom 已上移避开图例高度。
+     */
+    offsetY?: number;
+};
+
+declare type __VLS_Props_3 = {
+    /** MapView 实例 */
+    view: default_3;
+    /**
+     * 停靠左右。右侧有业务抽屉时用 left；左侧有面板时用 right。
+     */
+    position?: LegendDockPosition;
+    /** 水平边距（px） */
+    offsetX?: number;
+    /** 相对地图底边抬高（px） */
+    offsetY?: number;
+    /** 比例尺单位，默认公制 */
+    unit?: ScaleBarUnit;
+    /** 比例尺外观，默认线型 */
+    barStyle?: ScaleBarStyle;
+    /** 是否显示实时数字比例尺（如 1:40,000） */
+    showNumericScale?: boolean;
+    /** 数字比例尺是否显示千分位，默认 true */
+    numericScaleUseGrouping?: boolean;
+    /** 数字比例尺格式化函数；传入后优先使用 */
+    numericScaleFormatter?: NumericScaleFormatter;
+    /** 外层容器背景色 */
+    panelBackground?: string;
+    /** 外层容器边框色 */
+    panelBorderColor?: string;
+    /** 图形比例尺标题颜色 */
+    graphicLabelColor?: string;
+    /** 数字比例尺文字颜色 */
+    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: {
+        extra?(_: {}): any;
+    };
+    refs: {
+        layerSwipeRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+        view: default_3;
+        visible?: boolean;
+        idPrefix?: string;
+        }> & Readonly<{
+        onClose?: (() => any) | undefined;
+        }>, {
+        destroySwipe: () => void;
+        isSwipeActive: () => boolean;
+        }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+        close: () => any;
+        }, PublicProps, {
+        idPrefix: string;
+        visible: boolean;
+        }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+        leftSelectRef: HTMLDivElement;
+        rightSelectRef: HTMLDivElement;
+        }, any, ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+        }, Readonly<{
+        view: default_3;
+        visible?: boolean;
+        idPrefix?: string;
+        }> & Readonly<{
+        onClose?: (() => any) | undefined;
+        }>, {
+        destroySwipe: () => void;
+        isSwipeActive: () => boolean;
+        }, {}, {}, {}, {
+        idPrefix: string;
+        visible: boolean;
+        }> | null;
+    };
+    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 生效；找不到图层时跳过。
+ */
+export declare const applyBusinessLayerLabels: (map: default_2, configs: BusinessLayerLabelConfig[], options?: ApplyBusinessLayerLabelsOptions) => void;
+
+export declare type ApplyBusinessLayerLabelsOptions = {
+    idPrefix?: string;
+};
+
+/**
+ * 所有缩放级别都限制平移：
+ * ArcGIS 的 constraints.geometry 只约束「视图中心点」。
+ * 这里根据当前可视范围尺寸，反推中心点合法活动区域，
+ * 效果上等价于「矩形四条边始终不超出屏幕」。
+ * 拖到边缘直接停住，不做回弹；缩放、F11、窗口 resize 都会跟随重算。
+ *
+ * @returns 约束句柄，组件卸载时调用 remove() 释放
+ */
+export declare const applyPanBoundsConstraint: (view: default_3, lonLatExtent: LonLatExtent) => Promise<PanConstraintHandle>;
+
+export declare const ArcgisMap: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+ready: (payload: MapReadyPayload) => any;
+}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{
+onReady?: ((payload: MapReadyPayload) => any) | undefined;
+}>, {
+width: string | number;
+height: string | number;
+zoom: number;
+center: [number, number];
+keys: BasemapKeys | null;
+minZoom: number | null;
+maxZoom: number | null;
+panBounds: LonLatExtent | null;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+mapRef: HTMLDivElement;
+}, HTMLDivElement>;
+
+/** 底图密钥注入键；业务可在地图页 provide 一次，子组件按需 inject */
+export declare const BASEMAP_KEYS_KEY: InjectionKey<MaybeRef<BasemapKeys>>;
+
+export declare const BASEMAP_OPTIONS: Array<{
+    value: BasemapOptionId;
+    label: string;
+}>;
+
+/** 底图相关密钥（业务 props 传入） */
+export declare type BasemapKeys = {
+    tiandituKey?: string;
+    geovisToken?: string;
+    jl1mallMk?: string;
+    jl1mallToken?: string;
+};
+
+/** 底图选项 id，与下拉列表顺序一致 */
+export declare type BasemapOptionId = 'tianditu' | 'tiandituVec' | 'geovis' | 'jl1' | 'arcgis';
+
+export declare const BasemapSwitch: DefineComponent<ExtractPropTypes<    {
+/** MapView 实例 */
+view: {
+type: PropType<default_3>;
+required: true;
+};
+/** 底图密钥；未传时尝试 inject(BASEMAP_KEYS_KEY) */
+keys: {
+type: PropType<BasemapKeys | null>;
+default: null;
+};
+}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"before-change": () => any;
+}, string, PublicProps, Readonly<ExtractPropTypes<    {
+/** MapView 实例 */
+view: {
+type: PropType<default_3>;
+required: true;
+};
+/** 底图密钥；未传时尝试 inject(BASEMAP_KEYS_KEY) */
+keys: {
+type: PropType<BasemapKeys | null>;
+default: null;
+};
+}>> & Readonly<{
+"onBefore-change"?: (() => any) | undefined;
+}>, {
+keys: BasemapKeys | null;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {
+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 表达式（空格拼接）。
+ */
+export declare const buildLabelExpression: (fields: string[]) => string;
+
+/**
+ * 由字段模板生成 Arcade。
+ * 模板 '({0} 亩)({1})' → "(" + Text($feature["a"]) + " 亩)(" + Text($feature["b"]) + ")"
+ */
+export declare const buildLabelExpressionFromTemplate: (fields: string[], fieldTemplate: string) => string;
+
+/** 业务图层默认 id 前缀，与图层管理面板过滤规则一致 */
+export declare const BUSINESS_LAYER_ID_PREFIX = "bgl-biz-";
+
+/**
+ * 业务图层配置（字段对齐后台 mapServiceSettings）。
+ * 子系统特有的 popup / renderer 通过 resolveLayerProps 扩展。
+ */
+export declare type BusinessLayerConfig = {
+    id: string | number;
+    mapServiceUrl: string;
+    mapServiceName: string;
+    layerVisible?: boolean;
+    scaleConfig?: boolean | number | string;
+    minScale?: number | string;
+    maxScale?: number | string;
+    /** 1=MapServer，2=FeatureServer */
+    mapServiceType?: string | number;
+    layerOrder?: number | string;
+};
+
+/**
+ * 业务图层默认注记配置。
+ * 匹配优先 layerId，其次 title；表达式优先 expression，否则用 fields + fieldTemplate。
+ */
+export declare type BusinessLayerLabelConfig = {
+    /** 业务配置 id（不含前缀）或完整 layer.id */
+    layerId?: string | number;
+    /** 匹配 mapServiceName / layer.title */
+    title?: string;
+    /** 字段列表，库内拼 Arcade */
+    fields?: string[];
+    /**
+     * 字段模板，`{n}` 对应 fields[n]。
+     * 例：'({0} 亩)({1})' → "(" + Text($feature["f0"]) + " 亩)(" + Text($feature["f1"]) + ")"
+     * 不传则用空格拼接各 Text($feature["x"])
+     */
+    fieldTemplate?: string;
+    /** 直接写 Arcade（优先于 fields） */
+    expression?: string;
+    style?: BusinessLayerLabelStyle;
+};
+
+/** 注记文字样式（对齐 forestpests 描边可读性） */
+export declare type BusinessLayerLabelStyle = {
+    /** '#1A7F37' 或 [r,g,b] / [r,g,b,a]（a 为 0~1 或 0~255） */
+    color?: string | number[];
+    fontSize?: number;
+    fontWeight?: 'normal' | 'bold';
+    haloColor?: string | number[];
+    haloSize?: number;
+    /** 默认 center-center，适合面要素 */
+    labelPlacement?: string;
+};
+
+/** 与参考项目 map.vue / SpatialAnalysis.js 一致的 Albers WKT */
+export declare const CGCS2000_ALBERS_WKT = "PROJCS[\"CGCS2000_Albers\",GEOGCS[\"GCS_China_Geodetic_Coordinate_System_2000\",DATUM[\"D_China_2000\",SPHEROID[\"CGCS2000\",6378137.0,298.257222101]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Albers\"],PARAMETER[\"False_Easting\",0.0],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Longitude_Of_Origin\",105.0],PARAMETER[\"Latitude_Of_1st_Point\",25.0],PARAMETER[\"Latitude_Of_2nd_Point\",47.0],PARAMETER[\"Scale_Factor\",0.0],PARAMETER[\"Central_Parallel\",0.0],PARAMETER[\"Azimuth\",0.0],PARAMETER[\"Longitude_Of_1st_Point\",0.0],PARAMETER[\"Longitude_Of_2nd_Point\",0.0],PARAMETER[\"Longitude_Of_Center\",0.0],PARAMETER[\"Latitude_Of_Center\",0.0],UNIT[\"Meter\",1.0]]";
+
+/**
+ * 比对两个坐标系：
+ * 1) 两边都有 wkid → 比 wkid
+ * 2) 否则两边都有 wkt → 比规范化 wkt
+ * 3) 否则无法可靠比较 → unreadable
+ */
+export declare const checkSpatialReferenceMatch: (expected: SpatialReferenceLike | null | undefined, actual: SpatialReferenceLike | null | undefined) => SpatialReferenceCheckStatus;
+
+/** 清空待创建登记（页面卸载 / 重新上图前调用） */
+export declare const clearPendingBusinessLayers: () => void;
+
+/** 坐标定位配置：候选项 + 默认选中坐标系 */
+export declare type CoordinateSystemConfig = {
+    defaultWkid: number;
+    options: CoordinateSystemOption[];
+};
+
+/** 坐标定位面板可切换的坐标系选项 */
+export declare type CoordinateSystemOption = {
+    wkid: number;
+    label: string;
+};
+
+/** 根据配置创建 LabelClass（含描边） */
+export declare const createBusinessLabelClass: (config: BusinessLayerLabelConfig) => default_6;
+
+/** 默认全量工具顺序 */
+export declare const DEFAULT_TOOLBAR_TOOLS: ToolbarToolId[];
+
+/** 拆除两侧卷帘（切底图等场景可选调用） */
+export declare const destroyAllSwipes: () => void;
+
+/** 应用某一侧卷帘前，拆除另一侧已激活的 Swipe */
+export declare const destroyOtherSwipe: (kind: SwipeKind) => void;
+
+/** 由系统参数解析出的期望坐标系 */
+export declare type ExpectedSpatialReference = {
+    /** 系统参数原始码（8848 仍保留为哨兵码） */
+    sourceCode: number;
+    wkid: number | null;
+    wkt: string | null;
+    /** 展示用名称 */
+    label: string;
+};
+
+/** 生成实际坐标系的简短展示文案 */
+export declare const formatSpatialReferenceLabel: (spatialReference: SpatialReferenceLike | null | undefined) => string;
+
+/** 读取当前创建参数（含 allConfigs，供面板排序） */
+export declare const getPendingBusinessLayerOptions: () => PendingBusinessLayerCreateOptions | null;
+
+/** 读取待创建列表；可按 id 前缀过滤 */
+export declare const getPendingBusinessLayers: (idPrefix?: string) => PendingBusinessLayerItem[];
+
+/** 读取单个图层的坐标系不一致信息 */
+export declare const getSpatialReferenceMismatch: (layerId: string) => SpatialReferenceMismatchInfo | null;
+
+/** 读取当前全部坐标系不一致记录 */
+export declare const getSpatialReferenceMismatches: () => SpatialReferenceMismatchInfo[];
+
+/**
+ * 定位到全图：与初始定位一致（minZoom + 范围中心）。
+ * 供工具栏「全图」等业务入口复用。
+ */
+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 type LegendDockPosition = 'left' | 'right';
+
+/**
+ * 通用业务图层加载器：配置 → Layer → map.addMany。
+ * - 按 mapServiceType/URL 区分 FeatureLayer / MapImageLayer
+ * - 同 id 重复加载会先移除旧层
+ * - resolveLayerProps 返回值与 base 浅合并
+ */
+export declare const loadBusinessLayers: (options: LoadBusinessLayersOptions) => default_5[];
+
+export declare type LoadBusinessLayersOptions = {
+    map: default_2;
+    layers: BusinessLayerConfig[];
+    /**
+     * 业务扩展钩子：返回值会与基础 props 浅合并（后写覆盖先写）。
+     * 返回 void 则仅用基础配置。
+     */
+    resolveLayerProps?: (item: BusinessLayerConfig, base: LayerProps) => LayerProps | void;
+    /**
+     * 为 true 时：layerOrder 升序后再反转 addMany（小 order 在上层，对齐参考项目）。
+     * 默认 false：小 order 先加在下层，大 order 在上层。
+     */
+    reverse?: boolean;
+    /** 图层 id 前缀，避免与地图内其它图层冲突；默认 BUSINESS_LAYER_ID_PREFIX */
+    idPrefix?: string;
+    /** FeatureLayer 的 outFields；默认不传（由服务决定），避免 ['*'] 拖垮属性查询 */
+    outFields?: string[];
+    /**
+     * 指定图层的默认地图注记（labelingInfo）。
+     * 上图后按 layerId / title 匹配 FeatureLayer 并应用。
+     */
+    labelConfigs?: BusinessLayerLabelConfig[];
+    /**
+     * 系统/业务图层期望坐标系（如 systemCoordinate）。
+     * 8848 会按业务约定解析为 CGCS2000_Albers WKT；其他值按 WKID。
+     * 传入后在图层 when() 成功时校验；不传则跳过校验。
+     */
+    expectedSpatialReferenceWkid?: number | null;
+    /**
+     * 坐标系校验回调（提示型，默认不拦截上图）。
+     * reason=mismatch 会登记到图层管理；unreadable 只回调/打日志，不登记红标。
+     */
+    onSpatialReferenceMismatch?: (info: SpatialReferenceMismatchInfo) => void;
+    /**
+     * Portal / Server 访问 token。
+     * 写入图层 customParameters，确保首轮元数据请求就带 token，避免 499 后再重试。
+     */
+    accessToken?: string;
+};
+
+/** 经纬度矩形范围（WGS84） */
+export declare type LonLatExtent = {
+    xmin: number;
+    ymin: number;
+    xmax: number;
+    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;
+offsetX: number;
+offsetY: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+legendContainerRef: HTMLDivElement;
+}, HTMLElement>;
+
+/** ArcgisMap 在 view 就绪后通过 ready 事件抛出的载荷 */
+export declare interface MapReadyPayload {
+    map: default_2;
+    view: default_3;
+    sketchLayer: default_4;
+}
+
+export declare const MapScaleBar: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{}>, {
+position: LegendDockPosition;
+offsetX: number;
+offsetY: number;
+unit: ScaleBarUnit;
+barStyle: ScaleBarStyle;
+showNumericScale: boolean;
+numericScaleUseGrouping: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+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。
+ */
+export declare const materializePendingBusinessLayer: (map: default_2, layerId: string) => default_5 | null;
+
+/** 合并注记所需 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;
+
+/** 数字比例尺格式化函数 */
+declare type NumericScaleFormatter = (scale: number) => string;
+
+/** 平移约束句柄：组件卸载时调用 remove() 释放 */
+export declare type PanConstraintHandle = {
+    remove(): void;
+    /** 包装 view.goTo，程序化定位期间临时放开边界约束 */
+    wrapViewGoTo(view: default_3): void;
+    /** 长期暂停约束（如 TXT 画图面板打开） */
+    suspend(): void;
+    /** 恢复约束 */
+    resume(): void;
+};
+
+/** 待创建业务图层的创建参数（勾选显示时使用） */
+export declare type PendingBusinessLayerCreateOptions = {
+    accessToken?: string;
+    labelConfigs?: BusinessLayerLabelConfig[];
+    expectedSpatialReferenceWkid?: number | null;
+    onSpatialReferenceMismatch?: (info: SpatialReferenceMismatchInfo) => void;
+    reverse?: boolean;
+    idPrefix?: string;
+    /** 完整配置（已上图 + 待创建），创建后用于重排 z 序 */
+    allConfigs: BusinessLayerConfig[];
+};
+
+/** 面板展示用的待创建项 */
+export declare type PendingBusinessLayerItem = {
+    id: string;
+    title: string;
+    layerOrder: number;
+    config: BusinessLayerConfig;
+};
+
+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;
+    username: string;
+    password: string;
+    /**
+     * 可选 token 服务地址。开发环境可走 Vite 代理，例如：
+     * `/gis-portal/portal/sharing/rest/generateToken`
+     */
+    tokenServiceUrl?: string;
+    /** token 有效分钟数，默认 120 */
+    expirationMinutes?: number;
+    /** 额外登记的 server 根路径（图层 host 与 portal 不一致时传入） */
+    extraServers?: string[];
+    /** generateToken 的 referer；默认 window.location.origin */
+    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 */
+    token: string;
+    /** 停止后续续期定时器 */
+    stop: () => void;
+};
+
+/** 自动续期额外选项 */
+export declare type PortalTokenRenewalOptions = PortalAuthOptions & {
+    /**
+     * 过期前多少分钟刷新；默认取 expirationMinutes 的 1/6（至少 5 分钟，且不超过一半）。
+     * 例：120 分钟有效 → 默认约提前 20 分钟续期。
+     */
+    renewBeforeMinutes?: number;
+    /**
+     * 续期失败回调（定时刷新失败时）；首次注册失败仍会抛错。
+     * 连续失败时库内会节流：首次立即回调，之后同一失败串最多约每 15 分钟回调一次。
+     */
+    onRenewError?: (error: unknown) => void;
+};
+
+/**
+ * 向后代提供底图密钥（通常由业务页或 ArcgisMap 调用）。
+ * 传入已解析的 keys（ComputedRef 或普通对象均可）。
+ */
+export declare const provideBasemapKeys: (keys: MaybeRef<BasemapKeys>) => void;
+
+/**
+ * 登记后端代签的 Portal token（不调用 generateToken）。
+ */
+export declare const registerPortalAccessToken: (options: PortalAccessTokenOptions) => string;
+
+/**
+ * 向 IdentityManager 注册 Portal token，并挂请求拦截器保证首轮带 token。
+ * 注意：前端持有账号密码仅适合内网联调；生产应由后端签发 token。
+ */
+export declare const registerPortalToken: (options: PortalAuthOptions) => Promise<string>;
+
+/**
+ * 按完整配置重排地图上已存在的业务图层 z 序。
+ * 分批 addMany 后调用，可恢复 layerOrder 决定的叠放次序；
+ * 仅在业务图层原有槽位间调整，不影响绘图层等其它图层。
+ */
+export declare const reorderBusinessLayers: (options: ReorderBusinessLayersOptions) => void;
+
+/** 按完整配置重排业务图层 z 序的入参 */
+export declare type ReorderBusinessLayersOptions = Pick<LoadBusinessLayersOptions, 'map' | 'layers' | 'reverse' | 'idPrefix'>;
+
+/**
+ * 将系统参数 systemCoordinate 解析为期望坐标系。
+ * 8848 → CGCS2000_Albers WKT；其他有限数字 → WKID。
+ */
+export declare const resolveExpectedSpatialReference: (systemCoordinate: number | string | null | undefined) => ExpectedSpatialReference | null;
+
+/** 解析最终 Arcade 表达式 */
+export declare const resolveLabelExpression: (config: BusinessLayerLabelConfig) => string;
+
+/**
+ * 解析后台 layerVisible：未配置默认可见；
+ * true/1/'1'/'true' 为可见，false/0/'0'/'false' 等为隐藏。
+ */
+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';
+
+/**
+ * 登记尚未上图的业务图层（默认隐藏）。
+ * 不 map.add，因此不会触发服务元数据请求；用户勾选时再 materialize。
+ */
+export declare const setPendingBusinessLayers: (layers: BusinessLayerConfig[], options: PendingBusinessLayerCreateOptions) => void;
+
+/** 是否应按 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';
+
+export declare type SpatialReferenceCheckStatus = 'match' | 'mismatch' | 'unreadable';
+
+/** 可参与比对的坐标系描述（图层 spatialReference 或期望值） */
+export declare type SpatialReferenceLike = {
+    wkid?: number | null;
+    latestWkid?: number | null;
+    wkt?: string | null;
+};
+
+/** 业务图层坐标系与系统期望不一致/无法读取时的回调信息 */
+export declare type SpatialReferenceMismatchInfo = {
+    layerId: string;
+    layerTitle: string;
+    layerUrl: string;
+    /**
+     * 系统参数原始码（含业务哨兵 8848）。
+     * Albers 场景下不是标准 EPSG WKID。
+     */
+    expectedWkid: number;
+    /** 图层可读到的 wkid/latestWkid；仅有 WKT 时为 null */
+    actualWkid: number | null;
+    /** mismatch=确认不一致；unreadable=无法可靠读取/比对 */
+    reason: SpatialReferenceCheckReason;
+    /** 期望坐标系展示名 */
+    expectedLabel: string;
+    /** 实际坐标系展示名 */
+    actualLabel: string;
+};
+
+/**
+ * 注册 Portal token，并在过期前自动续期（覆盖 IdentityManager 登记）。
+ * 页面卸载或不再需要时务必调用返回的 stop()。
+ * 注意：前端持有账号密码仅适合内网联调；生产应由后端签发 token。
+ */
+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: {
+type: PropType<default_3>;
+required: true;
+};
+/** 底图密钥；未传时尝试 inject(BASEMAP_KEYS_KEY) */
+keys: {
+type: PropType<BasemapKeys | null>;
+default: null;
+};
+}>, {
+destroySwipe: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
+/** MapView 实例 */
+view: {
+type: PropType<default_3>;
+required: true;
+};
+/** 底图密钥；未传时尝试 inject(BASEMAP_KEYS_KEY) */
+keys: {
+type: PropType<BasemapKeys | null>;
+default: null;
+};
+}>> & Readonly<{}>, {
+keys: BasemapKeys | null;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {
+swipeSelectRef: HTMLDivElement;
+}, HTMLDivElement>;
+
+/**
+ * 底图卷帘与业务图层卷帘互斥注册表。
+ * 两侧在挂载时登记 destroy，应用卷帘前拆除另一侧。
+ */
+declare type SwipeKind = 'basemap' | 'layer';
+
+/** 业务约定：8848 → CGCS2000_Albers */
+export declare const SYSTEM_COORDINATE_ALBERS_CODE = 8848;
+
+/** 生成业务图层 id，带前缀避免冲突 */
+export declare const toBusinessLayerId: (item: BusinessLayerConfig, idPrefix?: string) => string;
+
+/** @deprecated 请用 toLayerProps；保留兼容旧调用 */
+export declare const toFeatureLayerProps: (item: BusinessLayerConfig) => __esri.FeatureLayerProperties;
+
+/** 将后台配置转为图层基础构造参数 */
+export declare const toLayerProps: (item: BusinessLayerConfig, options?: Pick<LoadBusinessLayersOptions, "idPrefix" | "outFields" | "accessToken">) => LayerProps;
+
+/** 工具栏内置工具 id（不含坐标条，坐标条由 showCoordinate 控制） */
+export declare type ToolbarToolId = 'fullExtent' | 'fullscreen' | 'zoomIn' | 'zoomOut' | 'prevExtent' | 'nextExtent' | 'coordinateLocate' | 'distanceMeasure' | 'areaMeasure' | 'layerManage' | 'layerSwipe' | 'mapLabel' | 'conditionQuery' | 'txtDraw';
+
+/**
+ * 解析底图密钥：显式 props.keys 优先，否则取 inject，再否则空对象。
+ * propsKeys 请传 getter / toRef，例如 useBasemapKeys(() => props.keys)
+ */
+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 { }