ms-types 0.9.37 → 0.9.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.9.37",
+  "version": "0.9.38",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/lua/cv.lua

@@ -824,7 +824,7 @@ function _OpenCV.set(mat, options) return false end
 ---@return OpenCV.Mat|nil
 function _OpenCV.copyTo(mat, mask) return nil end
 
---- cvtColor
+--- cvtColor；源图通道必须和转换码一致，例如 COLOR_BGR2GRAY 要 3 通道。
 ---@param mat OpenCV.Mat
 ---@param code number
 ---@return OpenCV.Mat|nil
@@ -836,7 +836,7 @@ function _OpenCV.cvtColor(mat, code) return nil end
 ---@return OpenCV.Mat|nil
 function _OpenCV.threshold(mat, options) return nil end
 
---- adaptiveThreshold
+--- adaptiveThreshold，只接受 CV_8UC1。
 ---@param mat OpenCV.Mat
 ---@param options OpenCV.AdaptiveThresholdOptions
 ---@return OpenCV.Mat|nil
@@ -890,12 +890,12 @@ function _OpenCV.addWeighted(src1, options) return nil end
 ---@return OpenCV.Mat|nil
 function _OpenCV.convertScaleAbs(mat, options) return nil end
 
---- countNonZero
+--- countNonZero，只接受单通道 Mat；多通道返回 -1。
 ---@param mat OpenCV.Mat
 ---@return number
 function _OpenCV.countNonZero(mat) return 0 end
 
---- minMaxLoc
+--- minMaxLoc，只接受单通道 Mat；多通道返回 nil。可选 mask 必须是 CV_8UC1。
 ---@param mat OpenCV.Mat
 ---@param options OpenCV.MaskOptions|nil
 ---@return OpenCV.MinMaxLocResult|nil
@@ -935,13 +935,13 @@ function _OpenCV.blur(mat, options) return nil end
 ---@return OpenCV.Mat|nil
 function _OpenCV.medianBlur(mat, options) return nil end
 
---- bilateralFilter
+--- bilateralFilter，只接受 1 或 3 通道，深度 CV_8U 或 CV_32F。
 ---@param mat OpenCV.Mat
 ---@param options OpenCV.BilateralFilterOptions
 ---@return OpenCV.Mat|nil
 function _OpenCV.bilateralFilter(mat, options) return nil end
 
---- Canny
+--- Canny，只接受 8 位图（CV_8U，1/3/4 通道均可）。
 ---@param mat OpenCV.Mat
 ---@param options OpenCV.CannyOptions
 ---@return OpenCV.Mat|nil
@@ -959,7 +959,7 @@ function _OpenCV.Sobel(mat, options) return nil end
 ---@return OpenCV.Mat|nil
 function _OpenCV.Laplacian(mat, options) return nil end
 
---- equalizeHist
+--- equalizeHist，只接受 CV_8UC1。
 ---@param mat OpenCV.Mat
 ---@return OpenCV.Mat|nil
 function _OpenCV.equalizeHist(mat) return nil end
@@ -1130,7 +1130,7 @@ function _OpenCV.SIFT(mat, options) return nil end
 ---@return OpenCV.FeatureResult|nil
 function _OpenCV.ORB(mat, options) return nil end
 
---- FAST
+--- FAST，只接受 CV_8UC1。
 ---@param mat OpenCV.Mat
 ---@param options OpenCV.FASTOptions|nil
 ---@return OpenCV.FASTResult|nil
@@ -1237,7 +1237,7 @@ function _OpenCV.floodFill(mat, options) return nil end
 ---@return OpenCV.Point[]|nil
 function _OpenCV.convexHull(points, options) return nil end
 
---- moments
+--- moments；Mat 输入必须是单通道栅格或 2 通道点集。
 ---@param matOrPoints OpenCV.Mat|OpenCV.Point[]
 ---@param options OpenCV.MomentsOptions|nil
 ---@return OpenCV.MomentsResult|nil

package/types/lua/global.lua

@@ -121,18 +121,18 @@ function GetCpuThrottleDelay()
     return { minMs = 3, maxMs = 30 }
 end
 
---- 打印调试日志，等同 `logger.debug(...)`；可变参按空格拼接
+--- 打印调试日志，等同 `logger.debug(...)`
 ---@param ... any
 function logd(...) end
 
---- 打印信息日志，等同 `logger.info(...)`；可变参按空格拼接
+--- 打印信息日志，等同 `logger.info(...)`
 ---@param ... any
 function logi(...) end
 
---- 打印警告日志，等同 `logger.warn(...)`；可变参按空格拼接
+--- 打印警告日志，等同 `logger.warn(...)`
 ---@param ... any
 function logw(...) end
 
---- 打印错误日志，等同 `logger.error(...)`；可变参按空格拼接
+--- 打印错误日志，等同 `logger.error(...)`
 ---@param ... any
 function loge(...) end

package/types/lua/logger.lua

@@ -22,26 +22,22 @@ function _Logger.setMaxLogFileSize(size) end
 function _Logger.resetLogFile() end
 
 --- 输出调试日志（级别：debug）
---- 可变参数会按空格拼接为一行文本
---- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @param ... any 日志内容
 --- @return nil
 function _Logger.debug(...) end
 
 --- 输出信息日志（级别：info）
---- 可变参数会按空格拼接为一行文本
---- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @param ... any 日志内容
 --- @return nil
 function _Logger.info(...) end
 
 --- 输出警告日志（级别：warn）
---- 可变参数会按空格拼接为一行文本
---- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @param ... any 日志内容
 --- @return nil
 function _Logger.warn(...) end
 
 --- 输出错误日志（级别：error）
---- 可变参数会按空格拼接为一行文本
---- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @param ... any 日志内容
 --- @return nil
 function _Logger.error(...) end
 

package/types/opencv.d.ts

@@ -274,8 +274,10 @@ declare namespace cv {
   function copyTo(mat: Mat, mask?: Mat | null): Mat | null;
 
   // ---- 颜色 / 运算 ----
+  /** 源图通道必须和转换码一致，例如 `COLOR_BGR2GRAY` 要 3 通道。 */
   function cvtColor(mat: Mat, code: number): Mat | null;
   function threshold(mat: Mat, options: ThresholdOptions): Mat | null;
+  /** 只接受 `CV_8UC1`。 */
   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;
@@ -285,7 +287,9 @@ declare namespace cv {
   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;
+  /** 只接受单通道 Mat；多通道返回 `-1`。 */
   function countNonZero(mat: Mat): number;
+  /** 只接受单通道 Mat；多通道返回 `null`。可选 `mask` 必须是 `CV_8UC1`。 */
   function minMaxLoc(mat: Mat, options?: { mask?: Mat }): MinMaxLocResult | null;
   function mean(mat: Mat, options?: { mask?: Mat }): number[] | null;
   function split(mat: Mat): Mat[] | null;
@@ -295,10 +299,13 @@ declare namespace cv {
   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;
+  /** 只接受 1 或 3 通道，深度 `CV_8U` 或 `CV_32F`。 */
   function bilateralFilter(mat: Mat, options: { d?: number; sigmaColor?: number; sigmaSpace?: number }): Mat | null;
+  /** 只接受 8 位图（`CV_8U`，1/3/4 通道均可）。 */
   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;
+  /** 只接受 `CV_8UC1`。 */
   function equalizeHist(mat: Mat): Mat | null;
 
   // ---- 几何 / 绘制 ----
@@ -507,6 +514,7 @@ declare namespace cv {
   /** ORB 检测并计算描述子（二进制描述子，匹配常用 NORM_HAMMING） */
   function ORB(mat: Mat, options?: ORBOptions): FeatureResult | null;
   /** FAST 仅返回关键点（无描述子） */
+  /** 只接受 `CV_8UC1`。 */
   function FAST(mat: Mat, options?: FASTOptions): { keypoints: KeyPoint[] } | null;
 
   /** 暴力匹配描述子，返回 DMatch 数组 */
@@ -542,6 +550,7 @@ declare namespace cv {
   /** 就地洪水填充，返回填充像素数与外接矩形 */
   function floodFill(mat: Mat, options: FloodFillOptions): { filled: number; rect: Rect } | null;
   function convexHull(points: Point[], options?: { clockwise?: boolean }): Point[] | null;
+  /** Mat 输入必须是单通道栅格或 2 通道点集。 */
   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;