@ziztechnology/dial-library 0.0.6 → 0.0.8

package/README.md

@@ -13,14 +13,6 @@
 npm install @ziztechnology/dial-library
 ```
 
-```bash
-pnpm add @ziztechnology/dial-library
-```
-
-```bash
-yarn add @ziztechnology/dial-library
-```
-
 SDK 是 ESM 包，并自带 TypeScript 类型。
 
 ## 快速开始

package/dist/index.mjs

@@ -1,5 +1,22 @@
 import { Gunzip } from "fflate";
+const resolveLogIntervalMs = (intervalMs = void 0) => typeof intervalMs === "number" && Number.isFinite(intervalMs) && intervalMs > 0 ? intervalMs : 300;
+//#endregion
 //#region src/helper/debugger.ts
+const logIntervalMs = resolveLogIntervalMs();
+const lastLoggedAtByType = /* @__PURE__ */ new Map();
+const createLogTypeKey = (moduleName, scope, phase) => JSON.stringify([
+	moduleName,
+	scope,
+	phase
+]);
+const shouldLog = (moduleName, scope, phase) => {
+	const key = createLogTypeKey(moduleName, scope, phase);
+	const now = Date.now();
+	const lastLoggedAt = lastLoggedAtByType.get(key);
+	if (lastLoggedAt !== void 0 && now >= lastLoggedAt && now - lastLoggedAt < logIntervalMs) return false;
+	lastLoggedAtByType.set(key, now);
+	return true;
+};
 const stringifyDebugData = (data) => {
 	const seen = /* @__PURE__ */ new WeakSet();
 	return JSON.stringify(data, (_key, value) => {
@@ -18,6 +35,7 @@ const stringifyDebugData = (data) => {
 	}) ?? String(data);
 };
 const dialSdkDebugWarn = (moduleName, scope, phase, data) => {
+	if (!shouldLog(moduleName, scope, phase)) return;
 	const message = `[DIAL_SDK_DEBUG - ${moduleName}] ${scope}: ${phase}`;
 	try {
 		if (data === void 0) console.warn(message);
@@ -2057,6 +2075,7 @@ const noop = () => {
 //#endregion
 //#region src/sensor/driving_expression_player.ts
 const DEBUG_MODULE = "driving_expression_player.ts";
+const MAX_RETAINED_IMAGES = 3;
 const createDrivingExpressionPlayer = (container, options) => {
 	dialSdkDebugWarn(DEBUG_MODULE, "createDrivingExpressionPlayer", "called", {
 		container,
@@ -2086,6 +2105,8 @@ var DefaultDrivingExpressionPlayer = class {
 		this.reusableVideo = null;
 		this.activeTgs = null;
 		this.unsubscribePageLifecycle = null;
+		this.retainedImages = /* @__PURE__ */ new Map();
+		this.preloadedHintUrls = /* @__PURE__ */ new Set();
 		this.handleLifecyclePause = () => {
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.handleLifecyclePause", "called");
 			if (this.destroyed || this.lifecycleSuspended) {
@@ -2215,6 +2236,8 @@ var DefaultDrivingExpressionPlayer = class {
 		this.failedOperation = null;
 		this.cancelPendingWork();
 		this.releaseActiveMedia();
+		this.clearRetainedImages();
+		this.preloadedHintUrls.clear();
 		this.container.replaceChildren();
 		this.status = null;
 		this.desiredMedia = null;
@@ -2315,8 +2338,7 @@ var DefaultDrivingExpressionPlayer = class {
 		try {
 			switch (media.kind) {
 				case "image":
-					this.renderConfiguredFallback(status, false);
-					await this.loadImage(media.url, loadAbort.signal, operation);
+					await this.loadImage(status, media, loadAbort.signal, operation);
 					break;
 				case "video":
 					this.renderLoadingPlaceholder(status, media.coverUrl, operation, loadAbort.signal);
@@ -2361,12 +2383,27 @@ var DefaultDrivingExpressionPlayer = class {
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.load", "completed", { operation });
 		}
 	}
-	async loadImage(url, signal, operation) {
+	async loadImage(status, media, signal, operation) {
+		const { url } = media;
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.loadImage", "called", {
-			url,
+			status,
+			media,
 			signal,
 			operation
 		});
+		if (isRetainableImage(media)) {
+			const retained = this.takeRetainedImage(url);
+			if (retained !== null) {
+				this.container.replaceChildren(retained);
+				dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.loadImage", "resolved retained image", {
+					url,
+					operation,
+					image: retained
+				});
+				return;
+			}
+		}
+		this.renderConfiguredFallback(status, false);
 		const image = this.createImage();
 		await waitForElementEvent(image, "load", "error", signal, this.loadTimeoutMs, () => {
 			image.src = url;
@@ -2375,6 +2412,7 @@ var DefaultDrivingExpressionPlayer = class {
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.loadImage", "discarded", { operation });
 			return;
 		}
+		if (isRetainableImage(media)) this.retainImage(url, image);
 		this.container.replaceChildren(image);
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.loadImage", "resolved", {
 			url,
@@ -2382,6 +2420,29 @@ var DefaultDrivingExpressionPlayer = class {
 			image
 		});
 	}
+	takeRetainedImage(url) {
+		const image = this.retainedImages.get(url) ?? null;
+		if (image === null) return null;
+		this.retainedImages.delete(url);
+		this.retainedImages.set(url, image);
+		return image;
+	}
+	retainImage(url, image) {
+		const previous = this.retainedImages.get(url);
+		if (previous && previous !== image) previous.removeAttribute("src");
+		this.retainedImages.delete(url);
+		this.retainedImages.set(url, image);
+		while (this.retainedImages.size > MAX_RETAINED_IMAGES) {
+			const oldest = this.retainedImages.entries().next().value;
+			if (!oldest) break;
+			this.retainedImages.delete(oldest[0]);
+			oldest[1].removeAttribute("src");
+		}
+	}
+	clearRetainedImages() {
+		for (const image of this.retainedImages.values()) image.removeAttribute("src");
+		this.retainedImages.clear();
+	}
 	async loadVideo(url, mimeType, status, media, signal, operation) {
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.loadVideo", "called", {
 			url,
@@ -2705,11 +2766,13 @@ var DefaultDrivingExpressionPlayer = class {
 				const media = normalizeMedia(configured);
 				const hintUrl = mediaPreloadHint(media);
 				if (!hintUrl || !isPublicDrivingMediaUrl(hintUrl)) continue;
+				if (this.preloadedHintUrls.has(hintUrl) || this.retainedImages.has(hintUrl)) continue;
 				try {
 					const image = this.createImage();
 					await waitForElementEvent(image, "load", "error", preloadAbort.signal, this.loadTimeoutMs, () => {
 						image.src = hintUrl;
 					});
+					this.preloadedHintUrls.add(hintUrl);
 					image.removeAttribute("src");
 					dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.startPreloading.worker", "preloaded", {
 						status,
@@ -2917,6 +2980,14 @@ const normalizeMedia = (media) => {
 	});
 	return result;
 };
+const isRetainableImage = (media) => {
+	if (media.mimeType?.split(";", 1)[0]?.trim().toLowerCase() === "image/gif") return false;
+	try {
+		return !new URL(media.url).pathname.toLowerCase().endsWith(".gif");
+	} catch {
+		return false;
+	}
+};
 const firstInvalidMediaUrl = (media) => {
 	dialSdkDebugWarn(DEBUG_MODULE, "firstInvalidMediaUrl", "called", { media });
 	let values;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziztechnology/dial-library",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "private": false,
   "description": "Tooony 表盘工具函数、方法",
   "files": [