Merge pull request #640 from nofficalfs/Dev-NewVersionPrepare

Preparation for new version.

.editorconfig

@@ -0,0 +1,11 @@
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+
+[*.js]
+indent_style = tab
+indent_size = 4

.gitignore

@@ -6,4 +6,4 @@
 ehthumbs.db
 Thumbs.db
 localStorage.json
-.vscode
+.vscode

game/game.js

@@ -354,25 +354,77 @@
 				}
 			}],
 		},
-		announce:{
+		/**
-			init(){
+		 * **无名杀消息推送库**
-				_status._announce=document.createElement("Announce");
+		 * 
-				_status._announce_cache=new Map();
+		 * 通过`EventTarget`机制，实现消息推送和接收的解耦，
-				delete lib.announce.init;
+		 * 从而使消息接收方无需依赖发布方，发布方也无需考虑接收方
-			},
+		 * 
-			//推送一个对象给所有监听了name的订阅者。
+		 * > `lib.announce`不是`actor`模型，若不存在订阅者，则消息发送将无意义
+		 * 
+		 * @example
+		 * // 甲扩展（如《千幻聆音》）在角色皮肤切换后，调用：
+		 * lib.announce.publish("skinChange", {
+		 * 	player,
+		 * 	playerName: "zhangfei",
+		 * 	originSkin: "image/xxx.jpg",
+		 * 	currentSkin: "image/yyy.jpg"
+		 * });
+		 * 
+		 * // 乙扩展监听此`skinChange`事件，并修改自己扩展相关界面的图片：
+		 * const method = lib.announce.subscribe("skinChange", (e) => {
+		 * 	div.setBackgroundImage(e.currentSkin);
+		 * });
+		 * 
+		 * // 若此时乙扩展不想继续订阅`skinChange`事件，可以通过`unsubscribe`解除订阅
+		 * lib.announce.unsubscribe("skinChange", method);
+		 */
+		announce:new class{
+			constructor(){
+				/**
+				 * @type {HTMLElement}
+				 */
+				this._announce=document.createElement("Announce");
+				/**
+				 * @type {Map<string, any>}
+				 */
+				this._announce_cache=new Map();
+			}
+
+			/**
+			 * 推送任意数据给所有监听了指定事件的订阅者，并返回给定的数据
+			 * 
+			 * 若不存在订阅指定事件的订阅者，则推送的数据将无意义
+			 * 
+			 * @template T
+			 * @param {string} name - 要推送事件的名称
+			 * @param {T} values - 要推送的数据
+			 * @returns {T}
+			 */
 			publish(name,values){
-				if(_status._announce) _status._announce.dispatchEvent(new CustomEvent(name,{
+				if(this._announce) this._announce.dispatchEvent(new CustomEvent(name,{
 					detail:values
 				}));
 				return values;
-			},
+			}
-			//订阅name相关的事件。
+
+			/**
+			 * 订阅给定名字的事件，并返回给定的函数
+			 * 
+			 * 在事件触发时执行给定的函数
+			 * 
+			 * 给定的函数将被存储至当前实例中，用于取消订阅时获取
+			 * 
+			 * @template T
+			 * @param {string} name - 要订阅事件的名称
+			 * @param {(values: T) => void} method - 事件触发时执行的函数
+			 * @returns {(values: T) => void}
+			 */
 			subscribe(name,method){
-				if(_status._announce&&_status._announce_cache) {
+				if(this._announce&&this._announce_cache) {
 					let subscribeFunction;
-					if(_status._announce_cache.has(method)){
+					if(this._announce_cache.has(method)){
-						let records=_status._announce_cache.get(method);
+						let records=this._announce_cache.get(method);
 						subscribeFunction=records.get("Listener");
 						records.get("EventTargets").add(name);
 					}
@@ -381,21 +433,31 @@
 						let records=new Map();
 						records.set("Listener",subscribeFunction);
 						records.set("EventTargets",[name]);
-						_status._announce_cache.set(method,records);
+						this._announce_cache.set(method,records);
 					}
-					_status._announce.addEventListener(name,subscribeFunction);
+					this._announce.addEventListener(name,subscribeFunction);
 				}
 				return method;
-			},
+			}
-			//取消对事件name的订阅
+
+			/**
+			 * 取消指定事件某一函数的订阅，并返回该函数
+			 * 
+			 * 给定的函数将不再于事件触发时执行，其余同事件需触发的函数不受限制
+			 * 
+			 * @template T
+			 * @param {string} name - 要取消订阅事件的名称
+			 * @param {(values: T) => void} method - 订阅指定事件的函数
+			 * @returns {(values: T) => void}
+			 */
 			unsubscribe(name,method){
-				if(_status._announce&&_status._announce_cache&&_status._announce_cache.has(method)){
+				if(this._announce&&this._announce_cache&&this._announce_cache.has(method)){
-					let records=_status._announce_cache.get(method);
+					let records=this._announce_cache.get(method);
 					const listener=records.get("Listener");
 					let eventTargets=records.get("EventTargets");
 					eventTargets.remove(name);
-					if(eventTargets.length<=0) _status._announce_cache.remove(method);
+					if(eventTargets.length<=0) this._announce_cache.remove(method);
-					_status._announce.removeEventListener(name,listener);
+					this._announce.removeEventListener(name,listener);
 				}
 				return method;
 			}
@@ -9566,7 +9628,6 @@
 					delete _status.htmlbg;
 
 					window.game=game;
-					lib.announce.init();
 					// node:path library alternative
 					if (typeof module!="object"||typeof module.exports!="object") lib.init.js(`${lib.assetURL}game`,"path",()=>{
 						lib.path=window._noname_path;
@@ -11579,12 +11640,16 @@
 									result:result
 								});
 								var res=gen.next((lastEvent&&("result" in lastEvent))?lastEvent.result:null);
-								if(res.done) event.finish();
+								if(res.done) return event.finish();
-								else {
+								var currentResult=res.value;
-									var currentResult=res.value;
+								// TODO: use `event.debugger` to replace source
-									// TODO: use `event.debugger` to replace source
+								if(typeof currentResult=="function") yield currentResult;
-									if(typeof currentResult=="function") yield currentResult;
+								else{
-									else lastEvent=currentResult;
+									if(Array.isArray(currentResult)){
+										event.step=currentResult[1];
+										currentResult=currentResult[0];
+									}
+									lastEvent=currentResult;
 								}
 							}
 						}else if(item._parsed) return item;
@@ -41228,7 +41293,7 @@
 						event.callHandler(event.getDefaultHandlerType(),event,{
 							state:'end'
 						});
-						event.step++;
+						if(typeof event.step=="number") ++event.step;
 					}
 				}
 			}
@@ -58445,6 +58510,23 @@
 		},
 	};
 	const get={
+		/**
+		 * 获取当前内核版本信息
+		 * 
+		 * 目前仅考虑`chrome`, `firefox`和`safari`三种浏览器的信息，其余均归于其他范畴
+		 * 
+		 * > 其他后续或许会增加，但`IE`永无可能
+		 * 
+		 * @returns {["firefox" | "chrome" | "safari" | "other", number]}
+		 */
+		coreInfo(){
+			const regex=/(firefox|chrome|safari)\/([\d.]+)/;
+			let result;
+			if (!(result=userAgent.match(regex))) return ["other",NaN];
+			if (result[1]!="safari") return [result[1],parseInt(result[2])];
+			result=userAgent.match(/version\/([\d.]+).*safari/);
+			return ["safari",parseInt(result[1])];
+		},
 		/**
 		 * 返回 VCard[] 形式的所有牌，用于印卡将遍历
 		 * @param {Function} filter