tds-map-methods 0.0.0-stage → 0.1.1

package/types/components/map/methods/typhoonRequest.d.ts

@@ -0,0 +1,49 @@
+export interface TyphoonListItem {
+    num_inati: string;
+    num_nati: string;
+    name_en: string;
+    name_cn: string;
+    data_id?: string;
+    init_grade?: string | null;
+    first_seen_file?: string;
+    first_seen_ts?: string;
+    latest_ts?: string;
+    obs_points?: number;
+    fcst_sources?: number;
+}
+export interface TyphoonPoint {
+    datetime: string;
+    file_ts: string;
+    validtime: number;
+    lat: number;
+    lon: number;
+    prs_hpa: number | null;
+    wind_max_ms: number | null;
+    wind_gust_ms: number | null;
+    grade: string | null;
+    move_dir_deg: number | null;
+    move_speed_ms: number | null;
+    radius_7: (number | null)[];
+    radius_10: (number | null)[];
+    radius_12: (number | null)[];
+}
+export interface TyphoonForecast {
+    file_ts?: string;
+    points?: TyphoonPoint[];
+}
+export interface TyphoonDetail {
+    typhoon_num: string;
+    name_cn: string;
+    name_en: string;
+    updated?: string;
+    obs?: Record<string, TyphoonPoint[] | TyphoonForecast>;
+    fcst?: Record<string, TyphoonPoint[] | TyphoonForecast>;
+}
+export interface TyphoonRequestOptions {
+    serviceBaseUrl?: string;
+    dataPath?: string;
+    authorization?: string;
+    signal?: AbortSignal;
+}
+export declare function getTyphoonList(options?: TyphoonRequestOptions): Promise<TyphoonListItem[]>;
+export declare function getTyphoonDetail(typhoonNum: string, options?: TyphoonRequestOptions): Promise<TyphoonDetail>;

package/types/components/map/methods/utils.d.ts

@@ -0,0 +1,97 @@
+import { type Dayjs } from "dayjs";
+import { type MapMethodsConfig } from "./config";
+export declare function resolveSymFunction<T extends (...args: any[]) => any>(candidate: unknown): T | undefined;
+/** bbox经纬度转3857 */
+export declare function bboxFromLonlatTo3857(bbox: [number, number, number, number]): [number, number, number, number];
+/** 线性插值 */
+export declare function lerp(a: number, b: number, t: number): number;
+/**
+ * 对二维数组进行高斯模糊
+ * @param data 输入二维数组
+ * @param width 宽度
+ * @param height 高度
+ * @param kernelSize 卷积核大小，默认5
+ * @param sigma 标准差，默认1.2
+ * @returns 模糊后的二维数组
+ */
+export declare function gaussianBlur2D(data: (number | undefined)[][], width: number, height: number, kernelSize?: number, sigma?: number): (number | undefined)[][];
+export declare function normalizeSmoothnessLevel(value: unknown, defaultValue?: number, maxValue?: number): number;
+export declare function smoothGridByLevel(data: (number | undefined)[][], width: number, height: number, value: unknown): number[][];
+/**
+ * 像素坐标转EPSG:3857坐标
+ * @param x 像素x
+ * @param y 像素y
+ * @param width 图像宽度
+ * @param height 图像高度
+ * @param extent 地图范围[minX, minY, maxX, maxY]，EPSG:3857
+ * @returns [coordX, coordY] EPSG:3857坐标
+ */
+export declare function pixelTo3857(x: number, y: number, width: number, height: number, extent: [number, number, number, number]): [number, number];
+export declare function pixelToLngLat(x: number, y: number, width: number, height: number, bbox: [number, number, number, number]): [number, number];
+export declare function convertContourGeoJSONToLngLat(contourGeoJSON: any[], width: number, height: number, bbox: [number, number, number, number]): any[];
+/**
+ * 将等值线GeoJSON中的像素坐标转换为EPSG:3857坐标
+ * @param contourGeoJSON 生成的等值线GeoJSON对象数组
+ * @param width 图像宽度
+ * @param height 图像高度
+ * @param extent 地图范围[minX, minY, maxX, maxY]，EPSG:3857
+ * @returns 坐标已转换的等值线GeoJSON对象数组
+ */
+export declare function convertContourGeoJSONTo3857(contourGeoJSON: any[], width: number, height: number, extent: [number, number, number, number]): any[];
+export declare function bilinearInterpolate(arr: Float32Array, x: number, y: number, width: number, height: number): number;
+/**
+ * 从图片获取灰度数据，并返回归一化的灰度数组
+ * @param src 图片路径
+ * @param scope 灰度值对应的实际数据范围 [min, max]
+ * @param scopeBoundaries 范围边界，超过最大最小值是否忽略，true: 忽略-取undefined，false: 不忽略-取最大最小值
+ * @param authorization 请求头 Authorization
+ * @param options 额外选项，detectNoDataByBorderColor 控制是否启用边界背景色无值识别
+ * @returns Promise<number[] | undefined[]> 灰度数组，透明像素为undefined
+ */
+export declare function getGrayDataFromImage(src: string, scope: [number, number], scopeBoundaries?: [boolean, boolean], authorization?: string, options?: {
+    detectNoDataByBorderColor?: boolean;
+    signal?: AbortSignal;
+}): Promise<{
+    grayArr: (number | undefined)[];
+    width: number;
+    height: number;
+}>;
+export declare function parseCssNumber(s: string): number;
+export declare function parseAlpha(s: string): number;
+export declare function clampByte(v: number): number;
+/**
+ * 解析 css 颜色字符串（#rrggbb/#rgb 或 rgb()/rgba()）到 [r,g,b,a(0..255)]
+ */
+export declare function parseColorToRGBA(col: string): [number, number, number, number];
+export declare function getLegendItemsByScope(legend: Layer.Legend, legendScope?: [number, number] | []): Layer.Legend;
+export declare function getLegendValueScope(legend: Layer.Legend, legendScope?: [number, number] | []): [number, number] | undefined;
+export declare function generateLegend(legend: Layer.Legend, legendScope?: [number, number] | []): {
+    uniqueThresholds: number[];
+    colorMap: Record<number, string>;
+};
+type ContourParamsResult = {
+    width: number;
+    height: number;
+    extent: [number, number, number, number];
+    rawArr2D: (number | undefined)[][];
+    smoothArr2D: (number | undefined)[][];
+    uniqueThresholds: number[];
+    colorMap: {
+        [key: number]: string;
+    };
+} | undefined;
+/** 根据灰度图获取对应数据 */
+export declare function getContourParams(options: Layer.Config): Promise<ContourParamsResult>;
+/** 根据bbox比例自适应宽高 */
+export declare function getWidthAndHeight(extent: [number, number, number, number], maxWidth: number, maxHeight: number): {
+    width: number;
+    height: number;
+};
+export declare function getUrlFromTime(el: any, time: string | Dayjs, requestConfig?: Pick<MapMethodsConfig, "serviceBaseUrl" | "imageSize">): string | string[];
+/**
+ * 把单个数值映射为 rgba 数组（0..255）
+ * thresholds: 排序后的阈值数组
+ * colorsRGBA: 与 thresholds 对应的 rgba 数组（每项为 [r,g,b,a]）
+ */
+export declare function mapValueToRGBA(val: number, thresholds: number[], colorsRGBA: [number, number, number, number][], colorMode: Layer.LayerMode): [number, number, number, number];
+export {};

package/types/components/map/methods/webgpuRaster.d.ts

@@ -0,0 +1,13 @@
+type RasterColorizeOptions = {
+    width: number;
+    height: number;
+    rawArr2D: (number | undefined)[][];
+    smoothArr2D: (number | undefined)[][];
+    thresholds: number[];
+    colorsRGBA: [number, number, number, number][];
+    colorMode: Layer.LayerMode;
+    scope?: [number, number] | [];
+    softenMaskEdge?: boolean;
+};
+export declare function renderFcstCanvasByWebGPU(options: RasterColorizeOptions): Promise<HTMLCanvasElement>;
+export {};

package/types/components/map/methods/windLayer.d.ts

@@ -0,0 +1,23 @@
+import { FcstLayer } from "./fcstLayer";
+type ExtentLike = [number, number, number, number];
+export type WindVectorData = {
+    width: number;
+    height: number;
+    u: Float32Array;
+    v: Float32Array;
+    extent: ExtentLike;
+};
+export declare class WindLayer extends FcstLayer {
+    private windVectorCache;
+    private windVectorLoadingTasks;
+    private normalizeUrls;
+    private parseScopeValue;
+    private getComponentScope;
+    private buildWindSpeedGrid;
+    private prepareGrid;
+    private getWindVectorCacheKey;
+    getOrLoadWindVectorData(options?: any): Promise<WindVectorData | null>;
+    getOrLoadContourData(options?: any): Promise<any>;
+    getSourceFromParams(options?: any): Promise<import("ol/source").ImageCanvas>;
+}
+export {};

package/types/components/map/methods/windShaft.d.ts

@@ -0,0 +1,43 @@
+import ImageCanvasSource from "ol/source/ImageCanvas.js";
+import type { WindVectorData } from "./windLayer";
+type WindShaftResolvedConfig = {
+    pixelStep: number;
+    fontSize: number;
+    color: string;
+    minWindSpeed: number;
+    speedLevelStep: number;
+    maxLevel: number;
+    spriteCellSize: number;
+    baseFontSize: number;
+    iconYOffsetRatio: number;
+    firstRowMaxLevel: number;
+    firstRowStartX: number;
+    firstRowY: number;
+    secondRowOffsetX: number;
+    secondRowY: number;
+};
+export declare class WindShaft {
+    map: Layer.Map;
+    options: any;
+    contourCache: Map<string, WindVectorData>;
+    iconImagePromise: Promise<HTMLImageElement> | null;
+    externalWindDataProvider?: () => Promise<WindVectorData | null>;
+    constructor(map: Layer.Map, options: any, externalWindDataProvider?: () => Promise<WindVectorData | null>);
+    getClassName(): string;
+    normalizeUrls(url: unknown): string[];
+    getComponentScope(): [number, number];
+    getCacheKey(): string;
+    getRuntimeConfig(): Layer.Config["config"] & Record<string, any>;
+    getVisibleWindSpeedScope(): [number, number];
+    getWindShaftConfig(): WindShaftResolvedConfig;
+    getIconImage(): Promise<HTMLImageElement>;
+    getOrLoadWindData(): Promise<WindVectorData | null>;
+    createWindShaftSource(data: WindVectorData, iconImage: CanvasImageSource): ImageCanvasSource;
+    getSourceFromCache(): Promise<ImageCanvasSource>;
+    getSourceFromParams(): Promise<ImageCanvasSource>;
+    add(): Promise<void>;
+    delete(): void;
+    toggleVisible(visible: boolean): void;
+    updateParams(newOptions: Layer.Config): Promise<void>;
+}
+export {};

package/types/components/map/methods/wmsLayer.d.ts

@@ -0,0 +1,36 @@
+import { TileWMS } from "ol/source.js";
+type WmsLayerConfig = Record<string, string | number | boolean | string[] | undefined>;
+type WmsColorOptions = {
+    styles?: string;
+    colorScaleRange?: string | [number, number];
+    numColorBands?: string | number;
+    aboveMaxColor?: string;
+    belowMinColor?: string;
+    bgColor?: string;
+    logScale?: boolean | string;
+};
+export declare class WmsLayer {
+    map: Layer.Map;
+    options: Layer.Config;
+    constructor(map: Layer.Map, options: Layer.Config);
+    getClassName(): string;
+    getConfig(): Layer.Config["config"] & {
+        opacity?: number;
+        layerConfig?: WmsLayerConfig;
+    };
+    normalizeParamValue(value: unknown): string | undefined;
+    buildWmsParams(): Record<string, string>;
+    splitUrlAndParams(rawUrl: string): {
+        baseUrl: string;
+        urlParams: Record<string, string>;
+    };
+    getTintColorRGB(): [number, number, number] | null;
+    tintBlobToDataUrl(blob: Blob, tintRGB: [number, number, number]): Promise<string>;
+    createSource(): TileWMS;
+    add(): void;
+    delete(): void;
+    toggleVisible(visible: boolean): void;
+    updateParams(newOptions: Layer.Config): void;
+    updateColor(colorOptions: WmsColorOptions): void;
+}
+export {};

package/types/typings/layer.d.ts

@@ -0,0 +1,226 @@
+declare namespace Layer {
+  type Map = import("ol").Map;
+  type Dayjs = import("dayjs").Dayjs;
+
+  /** 图层类型：只显示图例，网格，渐变，等高线，可见性，箭头，micaps，uv风，风杆 */
+  type LegendType =
+    | "legend"
+    | "grid"
+    | "gradual"
+    | "isoline"
+    | "contour"
+    | "visible"
+    | "arrow"
+    | "micaps"
+    | "wms"
+    | "uv"
+    | "windShaft"
+    | "typhoon";
+  /** 图层模式：离散、渐变、网格 */
+  type LayerMode = "discrete" | "gradient" | "grid";
+  type Legend = {
+    name: string;
+    scope?: number[];
+    color: string;
+  }[];
+
+  interface Config {
+    /** 图层id，唯一标识 */
+    readonly id: string;
+    /** 图层标题 */
+    readonly title: string;
+    /** 图层标签 */
+    label: string;
+    /** 图层类型 */
+    type: LegendType | LegendType[];
+    /** 图层数据文件路径 */
+    filePath: string;
+    /** 主数据目录不可用时使用的备用目录 */
+    fallbackFilePath?: string;
+    /** 图层数据url地址 */
+    url?: string;
+    /** WMS service prefix. Overrides the global package configuration. */
+    serviceBaseUrl?: string;
+    /** 图层是否显示，默认true */
+    show?: boolean;
+    /** 菜单图标名称 */
+    icon?: string;
+    /** 目录接口返回的节点类型 */
+    fileListType?: "file" | "menu";
+    /** 数据单位 */
+    unit?: string;
+    /** 菜单项请求头 Authorization，优先于环境变量 */
+    authorization?: string;
+    /** 备用目录对应的 Authorization */
+    fallbackAuthorization?: string;
+    /** 数据时间 */
+    time?: string | Dayjs;
+    config: {
+      /** 是否缓存图层数据，默认false，---！！该参数准备作废！！--- */
+      cache?: boolean;
+      /** 图片边界取值bbox */
+      extent: [number, number, number, number];
+      /** 图层zIndex，默认0，数值越大越靠上 */
+      zIndex?: number;
+      /** 图层透明度，取值范围 0-1 */
+      opacity?: number;
+      /** 等值线线宽 */
+      lineWidth?: number;
+      /** 等值线线宽，优先于 lineWidth */
+      isolineLineWidth?: number;
+      /** 是否启用等值线平滑，默认 true */
+      isolineSmooth?: boolean;
+      /** 等值线平滑度，0 表示关闭，1-3 表示逐级增强，默认 1 */
+      isolineSmoothness?: number;
+      /** 色斑图是否使用与等值线相同的数值场和平滑边界，默认 false */
+      alignWithIsoline?: boolean;
+      /** 等值线颜色；true 表示跟随图例 */
+      isolineColor?: string | boolean;
+      /** 等值面边界颜色 */
+      isolineBorderColor?: string;
+      /** 是否绘制分级等值面 */
+      isolineFill?: boolean;
+      /** 是否沿等值线显示数值 */
+      showIsolineValue?: boolean;
+      /** showIsolineValue 的兼容配置名 */
+      showIsolineLabel?: boolean;
+      /** MICAPS 是否显示文本 */
+      showText?: boolean;
+      /** MICAPS 是否填色 */
+      showFillcolor?: boolean;
+      /** MICAPS 是否显示等值线 */
+      showIsoline?: boolean;
+      /** MICAPS 是否显示符号点 */
+      showPointMarkers?: boolean;
+      /** 图例色带范围 */
+      legend: Legend;
+      /** 图例色带类型 visible：不显示色带 legend: 显示色块文字 grid：显示网格色带 gradual：显示渐变色带 */
+      legendType: "visible" | "legend" | "grid" | "gradual";
+      /** 图例色带范围（图例下标），只有在legendType为visible时有效，空数组表示不限制范围 */
+      legendScope?: [] | [number, number];
+      /** 数据值域；不设置时，从 TDS 自动获取最大/最小值 */
+      scope?: [number, number];
+      /**
+       * 对栅格值进行二次计算后再参与绘制与查询。
+       * 返回 null/undefined/NaN 时，该像素按无效值处理。
+       * 也支持字符串符号引用，例如 #sym:valueTransform。
+       */
+      valueTransform?:
+        | ((
+            value: number,
+            context: {
+              x: number;
+              y: number;
+              width: number;
+              height: number;
+              source: "raw" | "smooth";
+            },
+          ) => number | null | undefined)
+        | string;
+      /**
+       * valueTransform 结果是否参与范围过滤，默认 true。
+       * false 时仅用于显示值，不改变过滤判定。
+       */
+      valueTransformAffectsScope?: boolean;
+      /** 掩膜边缘平滑开关，默认false */
+      smooth?: boolean;
+      /** Chaikin 平滑迭代次数，默认2，建议1-3，取值范围1-5 */
+      smoothIterations?: number;
+      mode: LayerMode;
+      /** tds图层配置项 */
+      layerConfig?: Record<string, any>;
+      /** grid图层配置项 */
+      gridConfig?: {
+        /** 网格文本像素间距，默认40，单位px */
+        pixelStep: number | string;
+        /** 网格文本字体大小，默认14，单位px */
+        fontSize: number | string;
+        /** 网格文本小数位数，默认1 */
+        decimals: number | string;
+        /** 网格文本颜色，默认#000 */
+        fontColor: string;
+        /** 网格文本描边颜色，默认#fff */
+        strokeColor: string;
+        /** 网格文本描边宽度，默认2，单位px */
+        strokeWidth: number | string;
+        /** 网格文本字体，默认Arial, sans-serif */
+        fontFamily: string;
+        /** 是否开启文本描边，默认true */
+        useDevicePixelRatio: boolean;
+      };
+      /** wind图层配置项 */
+      windConfig?: Record<string, any>;
+      /** windShaft图层配置项 */
+      windShaftConfig?: {
+        /** 风杆采样像素步长，默认20，单位px */
+        pixelStep?: number | string;
+        /** 风杆尺寸，默认18，单位px */
+        fontSize?: number | string;
+        /** 风杆叠加颜色，默认rgb(255,255,255) */
+        color?: string;
+        /** 过滤最小风速，默认0.01 */
+        minWindSpeed?: number | string;
+        /** 风速分级步长，默认2 */
+        speedLevelStep?: number | string;
+        /** 风速级别上限，默认30 */
+        maxLevel?: number | string;
+        /** 雪碧图单格尺寸，默认32 */
+        spriteCellSize?: number | string;
+        /** 图标缩放基准字号，默认32 */
+        baseFontSize?: number | string;
+        /** 图标Y轴偏移比例，默认0.7 */
+        iconYOffsetRatio?: number | string;
+        /** 雪碧图第一行最大等级，默认3 */
+        firstRowMaxLevel?: number | string;
+        /** 雪碧图第一行起始X，默认28 */
+        firstRowStartX?: number | string;
+        /** 雪碧图第一行Y，默认4 */
+        firstRowY?: number | string;
+        /** 雪碧图第二行X偏移，默认4 */
+        secondRowOffsetX?: number | string;
+        /** 雪碧图第二行Y，默认5 */
+        secondRowY?: number | string;
+      };
+      /** 台风路径图层配置 */
+      typhoonConfig?: {
+        /** Typhoon JSON service prefix. */
+        serviceBaseUrl?: string;
+        /** TDS fileServer 下的台风 JSON 目录 */
+        dataPath?: string;
+        /** 只加载指定台风编号；不传则加载列表内全部台风 */
+        typhoonNums?: string[];
+        /** 优先显示的实况/预报来源 */
+        sourcePriority?: string[];
+        /** 是否显示预报路径 */
+        showForecast?: boolean;
+        /** 加载后是否自动缩放到路径范围 */
+        fitToExtent?: boolean;
+      };
+    };
+  }
+
+  interface TimeInfoResult {
+    /** 单时次or多时次 */
+    type: TimeOrderType;
+    /** 数据经纬度四角范围 */
+    latLonBox: LatLonBox;
+    /** 时间序列数量 */
+    npts?: string;
+    /** 数据时间间隔 */
+    increment?: string;
+    /** 请求连接 */
+    url: string;
+    /** 时间单位（hour | hours | minute） */
+    units: string;
+    /** 时间序列 */
+    timeOrder: TimeOrder[];
+    /** 起始时间 */
+    startTime: Date;
+    /** 结束时间 */
+    endTime: Date;
+    /** 高度层信息 */
+    level?: string[];
+    heightAboveGround?: string;
+    [key: string]: any;
+  }
+}