ms-types 0.9.19 → 0.9.21

package/types/opencv.d.ts

@@ -0,0 +1,715 @@
+/**
+ * OpenCV 精简绑定（仅 JS）。Mat 以句柄字符串暴露，复杂参数优先用 Object。
+ * 这不是完整 cv2，只覆盖手机端高频能力。无中文方法别名，模块名仅为 `cv`。
+ *
+ * @example
+ * const src = cv.capture()
+ * const gray = cv.cvtColor(src, { code: cv.COLOR_BGR2GRAY })
+ * const edges = cv.Canny(gray, { threshold1: 100, threshold2: 200 })
+ * cv.imwrite('/tmp/e.png', edges)
+ * cv.release(src); cv.release(gray); cv.release(edges)
+ */
+declare namespace cv {
+  /** Mat 句柄，形如 `$CV_MAT$_…` */
+  type Mat = string;
+
+  interface Point {
+    x: number;
+    y: number;
+  }
+
+  interface Size {
+    width: number;
+    height: number;
+  }
+
+  interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  }
+
+  interface MatInfo extends Size {
+    channels: number;
+    type: number;
+    rows: number;
+    cols: number;
+  }
+
+  interface MinMaxLocResult {
+    minVal: number;
+    maxVal: number;
+    minLoc: Point;
+    maxLoc: Point;
+  }
+
+  interface MatchLocResult {
+    x: number;
+    y: number;
+    minVal: number;
+    maxVal: number;
+  }
+
+  interface RotatedRect {
+    center: Point;
+    size: Size;
+    angle: number;
+  }
+
+  interface ThresholdOptions {
+    thresh?: number;
+    maxval?: number;
+    type?: number;
+  }
+
+  interface AdaptiveThresholdOptions {
+    maxValue?: number;
+    adaptiveMethod?: number;
+    thresholdType?: number;
+    blockSize?: number;
+    C?: number;
+  }
+
+  interface InRangeOptions {
+    lowerb: number[];
+    upperb: number[];
+  }
+
+  interface BitwiseOptions {
+    src2: Mat;
+    mask?: Mat;
+  }
+
+  interface BlurOptions {
+    ksize: number | [number, number] | Size;
+    sigmaX?: number;
+    sigmaY?: number;
+  }
+
+  interface CannyOptions {
+    threshold1?: number;
+    threshold2?: number;
+    apertureSize?: number;
+    L2gradient?: boolean;
+  }
+
+  interface ResizeOptions {
+    width?: number;
+    height?: number;
+    fx?: number;
+    fy?: number;
+    interpolation?: number;
+  }
+
+  interface CropOptions {
+    x?: number;
+    y?: number;
+    ex?: number;
+    ey?: number;
+  }
+
+  interface DrawColorOptions {
+    color?: number[] | string;
+    thickness?: number;
+  }
+
+  interface RectangleOptions extends DrawColorOptions {
+    pt1: Point | [number, number];
+    pt2: Point | [number, number];
+  }
+
+  interface CircleOptions extends DrawColorOptions {
+    center: Point | [number, number];
+    radius: number;
+  }
+
+  interface LineOptions extends DrawColorOptions {
+    pt1: Point | [number, number];
+    pt2: Point | [number, number];
+  }
+
+  interface PutTextOptions extends DrawColorOptions {
+    text: string;
+    org: Point | [number, number];
+    fontFace?: number;
+    fontScale?: number;
+  }
+
+  interface MatchTemplateOptions {
+    method?: number;
+    mask?: Mat;
+  }
+
+  interface FindContoursOptions {
+    mode?: number;
+    method?: number;
+  }
+
+  interface MorphOptions {
+    kernel: Mat;
+    iterations?: number;
+  }
+
+  interface MorphologyExOptions extends MorphOptions {
+    op: number;
+  }
+
+  interface StructuringElementOptions {
+    shape?: number;
+    ksize: number | [number, number] | Size;
+  }
+
+  // ---- constants (常用子集) ----
+  const COLOR_BGR2GRAY: number;
+  const COLOR_GRAY2BGR: number;
+  const COLOR_BGR2RGB: number;
+  const COLOR_RGB2BGR: number;
+  const COLOR_BGR2HSV: number;
+  const COLOR_HSV2BGR: number;
+  const COLOR_BGRA2BGR: number;
+  const COLOR_BGR2BGRA: number;
+  const COLOR_BGRA2GRAY: number;
+  const COLOR_BGR2Lab: number;
+  const COLOR_Lab2BGR: number;
+
+  const THRESH_BINARY: number;
+  const THRESH_BINARY_INV: number;
+  const THRESH_OTSU: number;
+  const THRESH_TRUNC: number;
+  const THRESH_TOZERO: number;
+  const THRESH_TOZERO_INV: number;
+
+  const ADAPTIVE_THRESH_MEAN_C: number;
+  const ADAPTIVE_THRESH_GAUSSIAN_C: number;
+
+  const TM_SQDIFF: number;
+  const TM_SQDIFF_NORMED: number;
+  const TM_CCORR: number;
+  const TM_CCORR_NORMED: number;
+  const TM_CCOEFF: number;
+  const TM_CCOEFF_NORMED: number;
+
+  const RETR_EXTERNAL: number;
+  const RETR_LIST: number;
+  const RETR_CCOMP: number;
+  const RETR_TREE: number;
+  const CHAIN_APPROX_NONE: number;
+  const CHAIN_APPROX_SIMPLE: number;
+
+  const MORPH_RECT: number;
+  const MORPH_CROSS: number;
+  const MORPH_ELLIPSE: number;
+  const MORPH_ERODE: number;
+  const MORPH_DILATE: number;
+  const MORPH_OPEN: number;
+  const MORPH_CLOSE: number;
+  const MORPH_GRADIENT: number;
+  const MORPH_TOPHAT: number;
+  const MORPH_BLACKHAT: number;
+
+  const INTER_NEAREST: number;
+  const INTER_LINEAR: number;
+  const INTER_CUBIC: number;
+  const INTER_AREA: number;
+  const INTER_LANCZOS4: number;
+
+  const ROTATE_90_CLOCKWISE: number;
+  const ROTATE_180: number;
+  const ROTATE_90_COUNTERCLOCKWISE: number;
+
+  const BORDER_CONSTANT: number;
+  const BORDER_REPLICATE: number;
+  const BORDER_REFLECT: number;
+  const BORDER_REFLECT_101: number;
+  const BORDER_DEFAULT: number;
+
+  const IMREAD_COLOR: number;
+  const IMREAD_GRAYSCALE: number;
+  const IMREAD_UNCHANGED: number;
+
+  const FONT_HERSHEY_SIMPLEX: number;
+  const FONT_HERSHEY_PLAIN: number;
+  const FONT_HERSHEY_DUPLEX: number;
+  const FONT_HERSHEY_COMPLEX: number;
+
+  const CV_8UC1: number;
+  const CV_8UC3: number;
+  const CV_8UC4: number;
+  const CV_32FC1: number;
+  const CV_32FC3: number;
+
+  // ---- IO / 生命周期 ----
+  /** 截屏为 Mat；参数与 `image.captureScreen` 一致，无参全屏 */
+  function capture(
+    x?: number,
+    y?: number,
+    ex?: number,
+    ey?: number,
+  ): Mat | null;
+  /**
+   * 读取图片为 Mat 句柄。`cv` 中**唯一**支持路径类输入的加载入口（与 `image.readImage` 同源）：
+   * msbundle/res 相对路径、手机绝对路径、`$MS_IMG$_…` imageId、`screen` / `shortcut` /
+   * `actionScreenshot`、HTTP(S)、`media:n`、`data:image/...;base64,...` 等。
+   * 其它算子只接受 Mat 句柄。
+   */
+  function imread(path: string): Mat | null;
+  /** 仅解码 base64 / data URI；路径与 imageId 请用 `imread` */
+  function imdecode(data: string): Mat | null;
+  function imwrite(path: string, mat: Mat): boolean;
+  function imencode(ext: string, mat: Mat, quality?: number): string | null;
+  function fromImageId(imageId: string): Mat | null;
+  function toImageId(mat: Mat): string | null;
+  function Mat(options: { rows: number; cols: number; type?: number; scalar?: number[] }): Mat | null;
+  function zeros(options: { rows: number; cols: number; type?: number }): Mat | null;
+  function ones(options: { rows: number; cols: number; type?: number }): Mat | null;
+  function clone(mat: Mat): Mat | null;
+  function empty(mat: Mat): boolean;
+  function isRelease(mat: Mat): boolean;
+  function release(mat: Mat): void;
+  function releaseAll(): void;
+  function getSize(mat: Mat): MatInfo | null;
+  function at(mat: Mat, row: number, col: number): number[] | null;
+  function set(mat: Mat, options: { row: number; col: number; value: number | number[] }): boolean;
+  function copyTo(mat: Mat, mask?: Mat | null): Mat | null;
+
+  // ---- 颜色 / 运算 ----
+  function cvtColor(mat: Mat, code: number): Mat | null;
+  function threshold(mat: Mat, options: ThresholdOptions): Mat | null;
+  function adaptiveThreshold(mat: Mat, options: AdaptiveThresholdOptions): Mat | null;
+  function inRange(mat: Mat, options: InRangeOptions): Mat | null;
+  function bitwise_and(src1: Mat, options: BitwiseOptions): Mat | null;
+  function bitwise_or(src1: Mat, options: BitwiseOptions): Mat | null;
+  function bitwise_xor(src1: Mat, options: BitwiseOptions): Mat | null;
+  function bitwise_not(mat: Mat, options?: { mask?: Mat }): Mat | null;
+  function absdiff(src1: Mat, options: { src2: Mat }): Mat | null;
+  function addWeighted(src1: Mat, options: { src2: Mat; alpha?: number; beta?: number; gamma?: number }): Mat | null;
+  function convertScaleAbs(mat: Mat, options?: { alpha?: number; beta?: number }): Mat | null;
+  function countNonZero(mat: Mat): number;
+  function minMaxLoc(mat: Mat, options?: { mask?: Mat }): MinMaxLocResult | null;
+  function mean(mat: Mat, options?: { mask?: Mat }): number[] | null;
+  function split(mat: Mat): Mat[] | null;
+  function merge(channels: Mat[]): Mat | null;
+
+  // ---- 滤波 / 边缘 ----
+  function GaussianBlur(mat: Mat, options: BlurOptions): Mat | null;
+  function blur(mat: Mat, options: { ksize: number | [number, number] | Size }): Mat | null;
+  function medianBlur(mat: Mat, options: { ksize: number }): Mat | null;
+  function bilateralFilter(mat: Mat, options: { d?: number; sigmaColor?: number; sigmaSpace?: number }): Mat | null;
+  function Canny(mat: Mat, options: CannyOptions): Mat | null;
+  function Sobel(mat: Mat, options: { ddepth?: number; dx?: number; dy?: number; ksize?: number; scale?: number; delta?: number }): Mat | null;
+  function Laplacian(mat: Mat, options: { ddepth?: number; ksize?: number; scale?: number; delta?: number }): Mat | null;
+  function equalizeHist(mat: Mat): Mat | null;
+
+  // ---- 几何 / 绘制 ----
+  function resize(mat: Mat, options: ResizeOptions): Mat | null;
+  function crop(mat: Mat, options: CropOptions): Mat | null;
+  function rotate(mat: Mat, rotateCode: number): Mat | null;
+  function flip(mat: Mat, flipCode: number): Mat | null;
+  function copyMakeBorder(mat: Mat, options: { top?: number; bottom?: number; left?: number; right?: number; borderType?: number; value?: number[] }): Mat | null;
+  function getRotationMatrix2D(options: { center: Point | [number, number]; angle?: number; scale?: number }): Mat | null;
+  function warpAffine(mat: Mat, options: { M: Mat; width?: number; height?: number; flags?: number }): Mat | null;
+  /** 就地绘制，返回同一句柄 */
+  function rectangle(mat: Mat, options: RectangleOptions): Mat | null;
+  function circle(mat: Mat, options: CircleOptions): Mat | null;
+  function line(mat: Mat, options: LineOptions): Mat | null;
+  function putText(mat: Mat, options: PutTextOptions): Mat | null;
+  function fillPoly(mat: Mat, options: { pts: Point[][] | Point[]; color?: number[] | string }): Mat | null;
+  function polylines(mat: Mat, options: { pts: Point[][] | Point[]; isClosed?: boolean; color?: number[] | string; thickness?: number }): Mat | null;
+  function drawContours(mat: Mat, options: { contours: Point[][]; contourIdx?: number; color?: number[] | string; thickness?: number }): Mat | null;
+
+  // ---- 匹配 / 轮廓 / 形态学 ----
+  function matchTemplate(image: Mat, templ: Mat, options?: MatchTemplateOptions): Mat | null;
+  function matchTemplateLoc(image: Mat, templ: Mat, options?: MatchTemplateOptions): MatchLocResult | null;
+  function findContours(mat: Mat, options?: FindContoursOptions): { contours: Point[][]; hierarchy: number[][] } | null;
+  function boundingRect(matOrPoints: Mat | Point[]): Rect | null;
+  function minAreaRect(points: Point[]): RotatedRect | null;
+  function contourArea(matOrPoints: Mat | Point[], oriented?: boolean): number;
+  function arcLength(points: Point[], closed?: boolean): number;
+  function approxPolyDP(points: Point[], options: { epsilon?: number; closed?: boolean }): Point[] | null;
+  function erode(mat: Mat, options: MorphOptions): Mat | null;
+  function dilate(mat: Mat, options: MorphOptions): Mat | null;
+  function morphologyEx(mat: Mat, options: MorphologyExOptions): Mat | null;
+  function getStructuringElement(options: StructuringElementOptions): Mat | null;
+
+  // ---- 特征点 / 匹配 / 单应 ----
+  interface KeyPoint {
+    x: number;
+    y: number;
+    size: number;
+    angle: number;
+    response: number;
+    octave: number;
+    class_id: number;
+  }
+
+  interface DMatch {
+    queryIdx: number;
+    trainIdx: number;
+    distance: number;
+  }
+
+  interface FeatureResult {
+    keypoints: KeyPoint[];
+    /** 描述子 Mat 句柄；失败时可能为 null */
+    descriptors: Mat | null;
+  }
+
+  interface SIFTOptions {
+    nfeatures?: number;
+    nOctaveLayers?: number;
+    contrastThreshold?: number;
+    edgeThreshold?: number;
+    sigma?: number;
+    mask?: Mat;
+  }
+
+  interface ORBOptions {
+    nfeatures?: number;
+    scaleFactor?: number;
+    nlevels?: number;
+    mask?: Mat;
+  }
+
+  interface FASTOptions {
+    threshold?: number;
+    nonmaxSuppression?: boolean;
+    mask?: Mat;
+  }
+
+  interface MatcherOptions {
+    queryDescriptors?: Mat;
+    trainDescriptors?: Mat;
+    normType?: number;
+    crossCheck?: boolean;
+  }
+
+  interface KnnMatchOptions extends MatcherOptions {
+    k?: number;
+    /** Lowe ratio test，例如 0.75；设置后只返回通过筛选的最近邻 */
+    ratio?: number;
+  }
+
+  interface DrawKeypointsOptions {
+    keypoints: KeyPoint[];
+    color?: number[] | string;
+  }
+
+  interface DrawMatchesOptions {
+    img2: Mat;
+    keypoints1: KeyPoint[];
+    keypoints2: KeyPoint[];
+    matches1to2: DMatch[];
+  }
+
+  interface FindHomographyOptions {
+    srcPoints: Point[];
+    dstPoints: Point[];
+    method?: number;
+    ransacReprojThreshold?: number;
+  }
+
+  interface WarpPerspectiveOptions {
+    M: Mat;
+    width?: number;
+    height?: number;
+    flags?: number;
+  }
+
+  interface GoodFeaturesOptions {
+    maxCorners?: number;
+    qualityLevel?: number;
+    minDistance?: number;
+    mask?: Mat;
+  }
+
+  interface HoughLinesPOptions {
+    rho?: number;
+    theta?: number;
+    threshold?: number;
+    minLineLength?: number;
+    maxLineGap?: number;
+  }
+
+  interface HoughCirclesOptions {
+    method?: number;
+    dp?: number;
+    minDist?: number;
+    param1?: number;
+    param2?: number;
+    minRadius?: number;
+    maxRadius?: number;
+  }
+
+  interface CLAHEOptions {
+    clipLimit?: number;
+    tileGridSize?: number | [number, number] | Size;
+  }
+
+  interface FloodFillOptions {
+    seedPoint: Point | [number, number];
+    newVal: number[] | string;
+    loDiff?: number[] | string;
+    upDiff?: number[] | string;
+  }
+
+  interface MomentsResult {
+    m00: number;
+    m10: number;
+    m01: number;
+    m20: number;
+    m11: number;
+    m02: number;
+    mu20: number;
+    mu11: number;
+    mu02: number;
+    nu20: number;
+    nu11: number;
+    nu02: number;
+  }
+
+  interface ConnectedComponentsResult {
+    count: number;
+    labels: Mat | null;
+    stats: Mat | null;
+    centroids: Mat | null;
+  }
+
+  const NORM_L1: number;
+  const NORM_L2: number;
+  const NORM_HAMMING: number;
+  const NORM_HAMMING2: number;
+  const RANSAC: number;
+  const LMEDS: number;
+  const RHO: number;
+  const HOUGH_GRADIENT: number;
+  const HOUGH_GRADIENT_ALT: number;
+  const DIST_L1: number;
+  const DIST_L2: number;
+  const DIST_C: number;
+  const DIST_MASK_3: number;
+  const DIST_MASK_5: number;
+  const CONTOURS_MATCH_I1: number;
+  const CONTOURS_MATCH_I2: number;
+  const CONTOURS_MATCH_I3: number;
+  const CC_STAT_LEFT: number;
+  const CC_STAT_TOP: number;
+  const CC_STAT_WIDTH: number;
+  const CC_STAT_HEIGHT: number;
+  const CC_STAT_AREA: number;
+
+  /**
+   * SIFT 检测并计算描述子。
+   * @example
+   * const { keypoints, descriptors } = cv.SIFT(src, { nfeatures: 500 })
+   */
+  function SIFT(mat: Mat, options?: SIFTOptions): FeatureResult | null;
+  /** ORB 检测并计算描述子（二进制描述子，匹配常用 NORM_HAMMING） */
+  function ORB(mat: Mat, options?: ORBOptions): FeatureResult | null;
+  /** FAST 仅返回关键点（无描述子） */
+  function FAST(mat: Mat, options?: FASTOptions): { keypoints: KeyPoint[] } | null;
+
+  /** 暴力匹配描述子，返回 DMatch 数组 */
+  function BFMatcher(queryDescriptors: Mat, trainDescriptors: Mat, options?: MatcherOptions): DMatch[] | null;
+  /** K 近邻匹配；可设 ratio 做 Lowe 筛选 */
+  function knnMatch(queryDescriptors: Mat, trainDescriptors: Mat, options?: KnnMatchOptions): DMatch[][] | null;
+
+  /** 绘制关键点，返回新 Mat 句柄 */
+  function drawKeypoints(mat: Mat, options: DrawKeypointsOptions): Mat | null;
+  /** 绘制匹配连线 */
+  function drawMatches(mat: Mat, options: DrawMatchesOptions): Mat | null;
+
+  /** 计算单应矩阵，返回 3x3 Mat 句柄 */
+  function findHomography(options: FindHomographyOptions): Mat | null;
+  /** 透视变换图像 */
+  function warpPerspective(mat: Mat, options: WarpPerspectiveOptions): Mat | null;
+  /** 用单应矩阵变换点集 */
+  function perspectiveTransform(points: Point[], options: { M: Mat }): Point[] | null;
+
+  /** Shi-Tomasi 角点 */
+  function goodFeaturesToTrack(mat: Mat, options: GoodFeaturesOptions): Point[] | null;
+  /** 概率霍夫直线，返回 {x1,y1,x2,y2}[] */
+  function HoughLinesP(mat: Mat, options: HoughLinesPOptions): Array<{ x1: number; y1: number; x2: number; y2: number }> | null;
+  /** 霍夫圆，返回 {x,y,radius}[] */
+  function HoughCircles(mat: Mat, options: HoughCirclesOptions): Array<{ x: number; y: number; radius: number }> | null;
+
+  /** CLAHE 对比度受限自适应直方图均衡 */
+  function CLAHE(mat: Mat, options?: CLAHEOptions): Mat | null;
+  function pyrDown(mat: Mat): Mat | null;
+  function pyrUp(mat: Mat): Mat | null;
+  function Scharr(mat: Mat, options: { ddepth?: number; dx?: number; dy?: number; scale?: number; delta?: number }): Mat | null;
+  function boxFilter(mat: Mat, options: { ksize: number | [number, number] | Size; ddepth?: number }): Mat | null;
+  /** 就地洪水填充，返回填充像素数与外接矩形 */
+  function floodFill(mat: Mat, options: FloodFillOptions): { filled: number; rect: Rect } | null;
+  function convexHull(points: Point[], options?: { clockwise?: boolean }): Point[] | null;
+  function moments(matOrPoints: Mat | Point[], options?: { binaryImage?: boolean }): MomentsResult | null;
+  function matchShapes(contour1: Mat | Point[], contour2: Mat | Point[], options?: { method?: number; parameter?: number }): number;
+  function connectedComponentsWithStats(mat: Mat): ConnectedComponentsResult | null;
+  function distanceTransform(mat: Mat, options?: { distanceType?: number; maskSize?: number }): Mat | null;
+
+  // ---- 算术 / 归一化 / 拼接 ----
+  function add(src1: Mat, options: { src2: Mat; mask?: Mat }): Mat | null;
+  function subtract(src1: Mat, options: { src2: Mat; mask?: Mat }): Mat | null;
+  function multiply(src1: Mat, options: { src2: Mat; scale?: number }): Mat | null;
+  function divide(src1: Mat, options: { src2: Mat; scale?: number }): Mat | null;
+  function normalize(mat: Mat, options?: { alpha?: number; beta?: number; normType?: number }): Mat | null;
+  function norm(mat: Mat, options?: { normType?: number; mask?: Mat; src2?: Mat }): number;
+  function meanStdDev(mat: Mat, options?: { mask?: Mat }): { mean: number[]; stddev: number[] } | null;
+  function findNonZero(mat: Mat): Point[] | null;
+  function hconcat(mats: Mat[]): Mat | null;
+  function vconcat(mats: Mat[]): Mat | null;
+
+  // ---- 已知点变换矩阵 ----
+  function getPerspectiveTransform(options: { srcPoints: Point[]; dstPoints: Point[] }): Mat | null;
+  function getAffineTransform(options: { srcPoints: Point[]; dstPoints: Point[] }): Mat | null;
+
+  // ---- Flann（SIFT 推荐，与 image 找图同源）----
+  function FlannBasedMatcher(queryDescriptors: Mat, trainDescriptors: Mat): DMatch[] | null;
+  function flannKnnMatch(queryDescriptors: Mat, trainDescriptors: Mat, options?: { k?: number; ratio?: number }): DMatch[][] | null;
+
+  // ---- 直方图 ----
+  function calcHist(mat: Mat, options?: {
+    channels?: number[];
+    histSize?: number[];
+    ranges?: number[];
+    mask?: Mat;
+    accumulate?: boolean;
+  }): Mat | null;
+  function compareHist(H1: Mat, H2: Mat, options?: { method?: number }): number;
+
+  // ---- 轮廓几何配套 ----
+  function boxPoints(options: { center: Point; size: Size | [number, number]; angle?: number }): Point[] | null;
+  function pointPolygonTest(contour: Point[], ptOrOptions: Point | { pt: Point; measureDist?: boolean }): number;
+  function minEnclosingCircle(points: Point[]): { center: Point; radius: number } | null;
+  /** 椭圆拟合，至少 5 个点；可用于圆形/椭圆控件轮廓 */
+  function fitEllipse(points: Point[]): RotatedRect | null;
+  function filter2D(mat: Mat, options: { kernel: Mat; ddepth?: number; delta?: number }): Mat | null;
+  function ellipse(mat: Mat, options: {
+    center: Point;
+    axes: Size | [number, number];
+    angle?: number;
+    startAngle?: number;
+    endAngle?: number;
+    color?: number[] | string;
+    thickness?: number;
+  }): Mat | null;
+  function getTextSize(options: {
+    text: string;
+    fontFace?: number;
+    fontScale?: number;
+    thickness?: number;
+  }): { width: number; height: number; baseLine: number } | null;
+
+  // ---- QR / 条码 ----
+  /** 编码二维码为可显示/可识别的 BGR Mat（已放大并加静区，可直接 detectQRCode） */
+  function encodeQRCode(text: string): Mat | null;
+  function detectQRCode(mat: Mat): { decoded: string; points: Point[] } | null;
+  function detectBarcode(mat: Mat): { decoded: string[]; types: string[]; points: Point[] } | null;
+
+  // ---- Photo ----
+  function inpaint(mat: Mat, options: { mask: Mat; inpaintRadius?: number; flags?: number }): Mat | null;
+  function fastNlMeansDenoising(mat: Mat, options?: {
+    h?: number; templateWindowSize?: number; searchWindowSize?: number;
+  }): Mat | null;
+  function fastNlMeansDenoisingColored(mat: Mat, options?: {
+    h?: number; hColor?: number; templateWindowSize?: number; searchWindowSize?: number;
+  }): Mat | null;
+
+  // ---- Core 扩展 ----
+  function LUT(mat: Mat, options: { lut: Mat }): Mat | null;
+  function compare(src1: Mat, options: { src2: Mat; cmpop: number }): Mat | null;
+  function min(src1: Mat, options: { src2: Mat }): Mat | null;
+  function max(src1: Mat, options: { src2: Mat }): Mat | null;
+  function extractChannel(mat: Mat, options: { coi: number }): Mat | null;
+  function sum(mat: Mat): number[] | null;
+
+  // ---- Imgproc 几何 / 滤波扩展 ----
+  function invertAffineTransform(M: Mat): Mat | null;
+  function getRectSubPix(mat: Mat, options: {
+    patchSize: Size | [number, number]; center: Point;
+  }): Mat | null;
+  /** 相位相关估计两图位移（如滚动/拖拽前后帧） */
+  function phaseCorrelate(src1: Mat, options: { src2: Mat; window?: Mat }): {
+    x: number; y: number; response?: number;
+  } | null;
+  function cornerHarris(mat: Mat, options?: { blockSize?: number; ksize?: number; k?: number }): Mat | null;
+  function cornerSubPix(mat: Mat, options: {
+    corners: Point[];
+    winSize?: Size | [number, number];
+    zeroZone?: Size | [number, number];
+    criteria?: { type?: number; maxCount?: number; epsilon?: number };
+  }): Point[] | null;
+  function calcBackProject(mat: Mat, options: {
+    hist: Mat; channels?: number[]; ranges?: number[]; scale?: number;
+  }): Mat | null;
+  function HuMoments(contourOrMoments: Point[] | MomentsResult): number[] | null;
+  function connectedComponents(mat: Mat, options?: { connectivity?: number }): {
+    count: number; labels: Mat;
+  } | null;
+  function convexityDefects(contour: Point[], options: {
+    hull: number[] | Point[];
+  }): Array<{ start: number; end: number; farthest: number; depth: number }> | null;
+  function isContourConvex(contour: Point[]): boolean;
+  function fitLine(points: Point[], options?: {
+    distType?: number; param?: number; reps?: number; aeps?: number;
+  }): [number, number, number, number] | null;
+
+  /** 就地绘制标记点，返回原句柄 */
+  function drawMarker(mat: Mat, options: {
+    position: Point; color?: number[] | string;
+    markerType?: number; markerSize?: number; thickness?: number;
+  }): Mat | null;
+  /** 就地画箭头线，返回原句柄 */
+  function arrowedLine(mat: Mat, options: {
+    pt1: Point; pt2: Point; color?: number[] | string; thickness?: number; tipLength?: number;
+  }): Mat | null;
+  /** 就地填充凸多边形，返回原句柄 */
+  function fillConvexPoly(mat: Mat, options: {
+    pts: Point[]; color?: number[] | string;
+  }): Mat | null;
+
+  // ---- Calib3d ----
+  function estimateAffine2D(options: {
+    srcPoints: Point[]; dstPoints: Point[]; method?: number; ransacReprojThreshold?: number;
+  }): Mat | null;
+  /** 相似变换（平移+旋转+等比缩放，无剪切），点对齐/跨分辨率匹配常用 */
+  function estimateAffinePartial2D(options: {
+    srcPoints: Point[]; dstPoints: Point[]; method?: number; ransacReprojThreshold?: number;
+  }): Mat | null;
+
+  // ---- Features 扩展 ----
+
+  // ---- Objdetect ----
+
+  const COLOR_RGB2GRAY: number;
+  const COLOR_RGBA2GRAY: number;
+  const LINE_4: number;
+  const LINE_8: number;
+  const LINE_AA: number;
+  const FILLED: number;
+  const HISTCMP_CORREL: number;
+  const HISTCMP_CHISQR: number;
+  const HISTCMP_INTERSECT: number;
+  const HISTCMP_BHATTACHARYYA: number;
+  const HISTCMP_CHISQR_ALT: number;
+  const HISTCMP_KL_DIV: number;
+  const NORM_INF: number;
+  const NORM_MINMAX: number;
+
+  const INPAINT_NS: number;
+  const INPAINT_TELEA: number;
+  const CMP_EQ: number;
+  const CMP_GT: number;
+  const CMP_GE: number;
+  const CMP_LT: number;
+  const CMP_LE: number;
+  const CMP_NE: number;
+  const MORPH_HITMISS: number;
+  const MARKER_CROSS: number;
+  const MARKER_TILTED_CROSS: number;
+  const MARKER_STAR: number;
+  const MARKER_DIAMOND: number;
+  const MARKER_SQUARE: number;
+  const MARKER_TRIANGLE_UP: number;
+  const MARKER_TRIANGLE_DOWN: number;
+}