@midscene/shared 1.11.0 → 1.11.1-beta-20260818123028.0

package/dist/es/env/parse-model-config.mjs

@@ -5,7 +5,7 @@ import { assert } from "../utils.mjs";
 import { maskConfig, parseJson } from "./helper.mjs";
 import { initDebugConfig } from "./init-debug.mjs";
 const MODEL_CONFIG_DOC_URL = 'https://midscenejs.com/model-common-config.html';
-const getCurrentVersion = ()=>"1.11.0";
+const getCurrentVersion = ()=>"1.11.1-beta-20260818123028.0";
 const getInvalidModelFamilyMessage = (modelFamily)=>`Invalid MIDSCENE_MODEL_FAMILY value: ${modelFamily}. Current version v${getCurrentVersion()} accepts the following model families: ${MODEL_FAMILY_VALUES.join(', ')}. You can also visit ${MODEL_CONFIG_DOC_URL} for the latest configuration information.`;
 const KEYS_MAP = {
     insight: INSIGHT_MODEL_CONFIG_KEYS,

package/dist/es/img/index.mjs

@@ -1,4 +1,4 @@
 import { imageInfoOfBase64, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer, validateScreenshotBuffer } from "./info.mjs";
-import { convertImgBufferToJpeg, createImgBase64ByFormat, cropByRect, httpImg2Base64, inferBase64ImageFormat, localImg2Base64, normalizeBase64Image, normalizeScreenshotBase64, paddingToMatchBlockByBase64, parseBase64, preProcessImageUrl, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, zoomForGPT4o } from "./transform.mjs";
+import { convertImgBufferToJpeg, convertPngBase64ToJpeg, createImgBase64ByFormat, cropByRect, httpImg2Base64, inferBase64ImageFormat, localImg2Base64, normalizeBase64Image, normalizeScreenshotBase64, paddingToMatchBlockByBase64, parseBase64, preProcessImageUrl, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, zoomForGPT4o } from "./transform.mjs";
 import { annotateRects, compositeElementInfoImg, compositePointMarkerImg, processImageElementInfo } from "./box-select.mjs";
-export { annotateRects, compositeElementInfoImg, compositePointMarkerImg, convertImgBufferToJpeg, createImgBase64ByFormat, cropByRect, httpImg2Base64, imageInfoOfBase64, inferBase64ImageFormat, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer, localImg2Base64, normalizeBase64Image, normalizeScreenshotBase64, paddingToMatchBlockByBase64, parseBase64, preProcessImageUrl, processImageElementInfo, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, validateScreenshotBuffer, zoomForGPT4o };
+export { annotateRects, compositeElementInfoImg, compositePointMarkerImg, convertImgBufferToJpeg, convertPngBase64ToJpeg, createImgBase64ByFormat, cropByRect, httpImg2Base64, imageInfoOfBase64, inferBase64ImageFormat, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer, localImg2Base64, normalizeBase64Image, normalizeScreenshotBase64, paddingToMatchBlockByBase64, parseBase64, preProcessImageUrl, processImageElementInfo, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, validateScreenshotBuffer, zoomForGPT4o };

package/dist/es/img/transform.mjs

@@ -322,6 +322,12 @@ const parseBase64 = (fullBase64String)=>{
         });
     }
 };
+async function convertPngBase64ToJpeg(imageBase64, quality = 90) {
+    const { mimeType, body } = parseBase64(imageBase64);
+    if ('image/png' !== mimeType.toLowerCase()) return imageBase64;
+    const jpegBuffer = await convertImgBufferToJpeg(Buffer.from(body, 'base64'), quality);
+    return createImgBase64ByFormat('jpeg', jpegBuffer.toString('base64'));
+}
 async function scaleImage(imageBase64, scale) {
     if (scale <= 0) throw new Error('Scale factor must be positive');
     const { body } = parseBase64(imageBase64);
@@ -377,4 +383,4 @@ async function scaleImage(imageBase64, scale) {
         imageBase64: base64
     };
 }
-export { convertImgBufferToJpeg, createImgBase64ByFormat, cropByRect, httpImg2Base64, inferBase64ImageFormat, localImg2Base64, normalizeBase64Body, normalizeBase64Image, normalizeScreenshotBase64, paddingToMatchBlock, paddingToMatchBlockByBase64, parseBase64, photonFromBase64, photonToBase64, preProcessImageUrl, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, zoomForGPT4o };
+export { convertImgBufferToJpeg, convertPngBase64ToJpeg, createImgBase64ByFormat, cropByRect, httpImg2Base64, inferBase64ImageFormat, localImg2Base64, normalizeBase64Body, normalizeBase64Image, normalizeScreenshotBase64, paddingToMatchBlock, paddingToMatchBlockByBase64, parseBase64, photonFromBase64, photonToBase64, preProcessImageUrl, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, zoomForGPT4o };

package/dist/lib/env/parse-model-config.js

@@ -37,7 +37,7 @@ const external_utils_js_namespaceObject = require("../utils.js");
 const external_helper_js_namespaceObject = require("./helper.js");
 const external_init_debug_js_namespaceObject = require("./init-debug.js");
 const MODEL_CONFIG_DOC_URL = 'https://midscenejs.com/model-common-config.html';
-const getCurrentVersion = ()=>"1.11.0";
+const getCurrentVersion = ()=>"1.11.1-beta-20260818123028.0";
 const getInvalidModelFamilyMessage = (modelFamily)=>`Invalid MIDSCENE_MODEL_FAMILY value: ${modelFamily}. Current version v${getCurrentVersion()} accepts the following model families: ${external_types_js_namespaceObject.MODEL_FAMILY_VALUES.join(', ')}. You can also visit ${MODEL_CONFIG_DOC_URL} for the latest configuration information.`;
 const KEYS_MAP = {
     insight: external_constants_js_namespaceObject.INSIGHT_MODEL_CONFIG_KEYS,

package/dist/lib/img/index.js

@@ -39,14 +39,15 @@ __webpack_require__.d(__webpack_exports__, {
     annotateRects: ()=>external_box_select_js_namespaceObject.annotateRects,
     compositeElementInfoImg: ()=>external_box_select_js_namespaceObject.compositeElementInfoImg,
     isValidPNGImageBuffer: ()=>external_info_js_namespaceObject.isValidPNGImageBuffer,
-    normalizeBase64Image: ()=>external_transform_js_namespaceObject.normalizeBase64Image,
-    compositePointMarkerImg: ()=>external_box_select_js_namespaceObject.compositePointMarkerImg,
     cropByRect: ()=>external_transform_js_namespaceObject.cropByRect,
+    compositePointMarkerImg: ()=>external_box_select_js_namespaceObject.compositePointMarkerImg,
+    normalizeBase64Image: ()=>external_transform_js_namespaceObject.normalizeBase64Image,
     isValidJPEGImageBuffer: ()=>external_info_js_namespaceObject.isValidJPEGImageBuffer,
+    convertPngBase64ToJpeg: ()=>external_transform_js_namespaceObject.convertPngBase64ToJpeg,
     processImageElementInfo: ()=>external_box_select_js_namespaceObject.processImageElementInfo,
     scaleImage: ()=>external_transform_js_namespaceObject.scaleImage,
-    zoomForGPT4o: ()=>external_transform_js_namespaceObject.zoomForGPT4o,
     createImgBase64ByFormat: ()=>external_transform_js_namespaceObject.createImgBase64ByFormat,
+    zoomForGPT4o: ()=>external_transform_js_namespaceObject.zoomForGPT4o,
     imageInfoOfBase64: ()=>external_info_js_namespaceObject.imageInfoOfBase64,
     httpImg2Base64: ()=>external_transform_js_namespaceObject.httpImg2Base64
 });
@@ -57,6 +58,7 @@ exports.annotateRects = __webpack_exports__.annotateRects;
 exports.compositeElementInfoImg = __webpack_exports__.compositeElementInfoImg;
 exports.compositePointMarkerImg = __webpack_exports__.compositePointMarkerImg;
 exports.convertImgBufferToJpeg = __webpack_exports__.convertImgBufferToJpeg;
+exports.convertPngBase64ToJpeg = __webpack_exports__.convertPngBase64ToJpeg;
 exports.createImgBase64ByFormat = __webpack_exports__.createImgBase64ByFormat;
 exports.cropByRect = __webpack_exports__.cropByRect;
 exports.httpImg2Base64 = __webpack_exports__.httpImg2Base64;
@@ -83,6 +85,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "compositeElementInfoImg",
     "compositePointMarkerImg",
     "convertImgBufferToJpeg",
+    "convertPngBase64ToJpeg",
     "createImgBase64ByFormat",
     "cropByRect",
     "httpImg2Base64",

package/dist/lib/img/transform.js

@@ -39,7 +39,7 @@ __webpack_require__.d(__webpack_exports__, {
     paddingToMatchBlockByBase64: ()=>paddingToMatchBlockByBase64,
     photonFromBase64: ()=>photonFromBase64,
     parseBase64: ()=>parseBase64,
-    httpImg2Base64: ()=>httpImg2Base64,
+    photonToBase64: ()=>photonToBase64,
     resizeAndConvertImgBuffer: ()=>resizeAndConvertImgBuffer,
     resizeImgBase64: ()=>resizeImgBase64,
     saveBase64Image: ()=>saveBase64Image,
@@ -50,9 +50,10 @@ __webpack_require__.d(__webpack_exports__, {
     normalizeBase64Image: ()=>normalizeBase64Image,
     normalizeBase64Body: ()=>normalizeBase64Body,
     zoomForGPT4o: ()=>zoomForGPT4o,
+    convertPngBase64ToJpeg: ()=>convertPngBase64ToJpeg,
     createImgBase64ByFormat: ()=>createImgBase64ByFormat,
     paddingToMatchBlock: ()=>paddingToMatchBlock,
-    photonToBase64: ()=>photonToBase64
+    httpImg2Base64: ()=>httpImg2Base64
 });
 const external_node_assert_namespaceObject = require("node:assert");
 var external_node_assert_default = /*#__PURE__*/ __webpack_require__.n(external_node_assert_namespaceObject);
@@ -382,6 +383,12 @@ const parseBase64 = (fullBase64String)=>{
         });
     }
 };
+async function convertPngBase64ToJpeg(imageBase64, quality = 90) {
+    const { mimeType, body } = parseBase64(imageBase64);
+    if ('image/png' !== mimeType.toLowerCase()) return imageBase64;
+    const jpegBuffer = await convertImgBufferToJpeg(external_node_buffer_namespaceObject.Buffer.from(body, 'base64'), quality);
+    return createImgBase64ByFormat('jpeg', jpegBuffer.toString('base64'));
+}
 async function scaleImage(imageBase64, scale) {
     if (scale <= 0) throw new Error('Scale factor must be positive');
     const { body } = parseBase64(imageBase64);
@@ -438,6 +445,7 @@ async function scaleImage(imageBase64, scale) {
     };
 }
 exports.convertImgBufferToJpeg = __webpack_exports__.convertImgBufferToJpeg;
+exports.convertPngBase64ToJpeg = __webpack_exports__.convertPngBase64ToJpeg;
 exports.createImgBase64ByFormat = __webpack_exports__.createImgBase64ByFormat;
 exports.cropByRect = __webpack_exports__.cropByRect;
 exports.httpImg2Base64 = __webpack_exports__.httpImg2Base64;
@@ -459,6 +467,7 @@ exports.scaleImage = __webpack_exports__.scaleImage;
 exports.zoomForGPT4o = __webpack_exports__.zoomForGPT4o;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "convertImgBufferToJpeg",
+    "convertPngBase64ToJpeg",
     "createImgBase64ByFormat",
     "cropByRect",
     "httpImg2Base64",

package/dist/types/img/index.d.ts

@@ -1,3 +1,3 @@
 export { imageInfoOfBase64, isValidPNGImageBuffer, isValidJPEGImageBuffer, isValidImageBuffer, validateScreenshotBuffer, type ValidateScreenshotBufferOptions, } from './info';
-export { resizeAndConvertImgBuffer, convertImgBufferToJpeg, resizeImgBase64, zoomForGPT4o, saveBase64Image, paddingToMatchBlockByBase64, cropByRect, scaleImage, localImg2Base64, httpImg2Base64, preProcessImageUrl, parseBase64, createImgBase64ByFormat, inferBase64ImageFormat, normalizeBase64Image, normalizeScreenshotBase64, type NormalizeScreenshotBase64Options, } from './transform';
+export { resizeAndConvertImgBuffer, convertImgBufferToJpeg, convertPngBase64ToJpeg, resizeImgBase64, zoomForGPT4o, saveBase64Image, paddingToMatchBlockByBase64, cropByRect, scaleImage, localImg2Base64, httpImg2Base64, preProcessImageUrl, parseBase64, createImgBase64ByFormat, inferBase64ImageFormat, normalizeBase64Image, normalizeScreenshotBase64, type NormalizeScreenshotBase64Options, } from './transform';
 export { processImageElementInfo, compositeElementInfoImg, compositePointMarkerImg, annotateRects, } from './box-select';

package/dist/types/img/transform.d.ts

@@ -94,6 +94,13 @@ export declare const parseBase64: (fullBase64String: string) => {
     mimeType: string;
     body: string;
 };
+/**
+ * Convert a PNG base64 image to JPEG while leaving other image formats unchanged.
+ * @param imageBase64 - Image data URL or raw base64 body.
+ * @param quality - JPEG quality from 1 to 100.
+ * @returns A JPEG data URL for PNG input, otherwise the original input.
+ */
+export declare function convertPngBase64ToJpeg(imageBase64: string, quality?: number): Promise<string>;
 /**
  * Scales an image by a specified factor using Sharp or Photon
  * @param imageBase64 - Base64 encoded image

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/shared",
-  "version": "1.11.0",
+  "version": "1.11.1-beta-20260818123028.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "types": "./dist/types/index.d.ts",

package/src/img/index.ts

@@ -9,6 +9,7 @@ export {
 export {
   resizeAndConvertImgBuffer,
   convertImgBufferToJpeg,
+  convertPngBase64ToJpeg,
   resizeImgBase64,
   zoomForGPT4o,
   saveBase64Image,

package/src/img/transform.ts

@@ -615,6 +615,26 @@ export const parseBase64 = (
   }
 };
 
+/**
+ * Convert a PNG base64 image to JPEG while leaving other image formats unchanged.
+ * @param imageBase64 - Image data URL or raw base64 body.
+ * @param quality - JPEG quality from 1 to 100.
+ * @returns A JPEG data URL for PNG input, otherwise the original input.
+ */
+export async function convertPngBase64ToJpeg(
+  imageBase64: string,
+  quality = 90,
+): Promise<string> {
+  const { mimeType, body } = parseBase64(imageBase64);
+  if (mimeType.toLowerCase() !== 'image/png') return imageBase64;
+
+  const jpegBuffer = await convertImgBufferToJpeg(
+    Buffer.from(body, 'base64'),
+    quality,
+  );
+  return createImgBase64ByFormat('jpeg', jpegBuffer.toString('base64'));
+}
+
 /**
  * Scales an image by a specified factor using Sharp or Photon
  * @param imageBase64 - Base64 encoded image