wikiparser-node 0.7.0-m → 0.7.0

package/util/debug.js

@@ -0,0 +1,73 @@
+'use strict';
+
+/**
+ * 定制TypeError消息
+ * @param {Function} constructor 类
+ * @param {string} method
+ * @param {...string} args 可接受的参数类型
+ * @throws `TypeError`
+ */
+const typeError = ({name}, method, ...args) => {
+	throw new TypeError(`${name}.${method} 方法仅接受 ${args.join('、')} 作为输入参数！`);
+};
+
+/**
+ * 不是被构造器或原型方法调用
+ * @param {string} name 方法名称
+ */
+const externalUse = name => {
+	const Parser = require('..');
+	if (Parser.running) {
+		return false;
+	}
+	const regex = new RegExp(`^new \\w*Token$|^(?:Ast\\w*|\\w*Token)\\.(?!${name}$)`, 'u');
+	try {
+		throw new Error(); // eslint-disable-line unicorn/error-message
+	} catch (e) {
+		if (e instanceof Error) {
+			const mt = e.stack.match(/(?<=^\s+at )(?:new )?[\w.]+(?= \(\/)/gmu);
+			return !mt.slice(2).some(func => regex.test(func));
+		}
+	}
+	return false;
+};
+
+/**
+ * 撤销最近一次Mutation
+ * @param {AstEvent} e 事件
+ * @param {AstEventData} data 事件数据
+ * @throws `RangeError` 无法撤销的事件类型
+ */
+const undo = (e, data) => {
+	const {target, type} = e;
+	switch (type) {
+		case 'remove': {
+			const childNodes = [...target.childNodes];
+			childNodes.splice(data.position, 0, data.removed);
+			data.removed.setAttribute('parentNode', target);
+			target.setAttribute('childNodes', childNodes);
+			break;
+		}
+		case 'insert': {
+			const childNodes = [...target.childNodes];
+			childNodes.splice(data.position, 1);
+			target.setAttribute('childNodes', childNodes);
+			break;
+		}
+		case 'replace': {
+			const {parentNode} = target,
+				childNodes = [...parentNode.childNodes];
+			childNodes.splice(data.position, 1, data.oldToken);
+			data.oldToken.setAttribute('parentNode', parentNode);
+			parentNode.setAttribute('childNodes', childNodes);
+			break;
+		}
+		case 'text':
+			target.replaceData(data.oldText);
+			break;
+		default:
+			throw new RangeError(`无法撤销未知类型的事件：${type}`);
+	}
+};
+
+module.exports = {typeError, externalUse, undo};

package/util/string.js

@@ -9,6 +9,23 @@ const extUrlCharFirst = '(?:\\[[\\da-f:.]+\\]|[^[\\]<>"\\0-\\x1F\\x7F\\p{Zs}\\uF
  */
 const removeComment = str => str.replace(/\0\d+c\x7F/gu, '');
 
+/**
+ * 以HTML格式打印
+ * @param {(AstText|AstElement)[]} childNodes 子节点
+ * @param {printOpt} opt 选项
+ */
+const print = (childNodes, opt = {}) => {
+	const AstText = require('../lib/text'),
+		AstElement = require('../lib/element');
+	const {pre = '', post = '', sep = ''} = opt,
+		entities = {'&': 'amp', '<': 'lt', '>': 'gt'};
+	return `${pre}${childNodes.map(
+		child => child instanceof AstElement
+			? child.print()
+			: String(child).replace(/[&<>]/gu, p => `&${entities[p]};`),
+	).join(sep)}${post}`;
+};
+
 /**
  * escape special chars for RegExp constructor
  * @param {string} str RegExp source
@@ -55,6 +72,36 @@ const text = (childNodes, separator = '') => {
 	return childNodes.map(child => typeof child === 'string' ? child : child.text()).join(separator);
 };
 
+/**
+ * optionally convert to lower cases
+ * @param {string} val 属性值
+ * @param {string|undefined} i 是否对大小写不敏感
+ */
+const toCase = (val, i) => i ? val.toLowerCase() : val;
+
+/**
+ * escape newlines
+ * @param {string} str 原字符串
+ */
+const noWrap = str => str.replaceAll('\n', '\\n');
+
+/**
+ * convert newline in text nodes to single whitespace
+ * @param {Token & {childNodes: AstText[]}} token 父节点
+ */
+const normalizeSpace = token => {
+	if (token === undefined) {
+		return;
+	}
+	const Token = require('../src'),
+		AstText = require('../lib/text');
+	for (const child of token.childNodes) {
+		if (child.type === 'text') {
+			child.replaceData(child.data.replaceAll('\n', ' '));
+		}
+	}
+};
+
 module.exports = {
-	extUrlCharFirst, extUrlChar, removeComment, escapeRegExp, explode, text,
+	extUrlCharFirst, extUrlChar, removeComment, print, escapeRegExp, explode, text, toCase, noWrap, normalizeSpace,
 };

package/config/minimum.json

@@ -1,142 +0,0 @@
-{
-	"ext": [],
-	"html": [
-		[
-			"b",
-			"bdi",
-			"del",
-			"i",
-			"ins",
-			"u",
-			"font",
-			"big",
-			"small",
-			"sub",
-			"sup",
-			"h1",
-			"h2",
-			"h3",
-			"h4",
-			"h5",
-			"h6",
-			"cite",
-			"code",
-			"em",
-			"s",
-			"strike",
-			"strong",
-			"tt",
-			"var",
-			"div",
-			"center",
-			"blockquote",
-			"ol",
-			"ul",
-			"dl",
-			"table",
-			"caption",
-			"pre",
-			"ruby",
-			"rb",
-			"rp",
-			"rt",
-			"rtc",
-			"p",
-			"span",
-			"abbr",
-			"dfn",
-			"kbd",
-			"samp",
-			"data",
-			"time",
-			"mark",
-			"tr",
-			"td",
-			"th",
-			"q",
-			"bdo"
-		],
-		[
-			"li",
-			"dt",
-			"dd"
-		],
-		[
-			"br",
-			"wbr",
-			"hr",
-			"meta",
-			"link",
-			"img"
-		]
-	],
-	"namespaces": {},
-	"nsid": {},
-	"parserFunction": [
-		{
-			"#language": "language",
-			"#special": "special",
-			"#speciale": "speciale",
-			"#tag": "tag",
-			"#formatdate": "formatdate",
-			"#invoke": "invoke",
-			"#while": "while",
-			"#dowhile": "dowhile",
-			"#loop": "loop",
-			"#forargs": "forargs",
-			"#fornumargs": "fornumargs",
-			"#if": "if",
-			"#ifeq": "ifeq",
-			"#switch": "switch",
-			"#ifexist": "ifexist",
-			"#ifexpr": "ifexpr",
-			"#iferror": "iferror",
-			"#time": "time",
-			"#timel": "timel",
-			"#expr": "expr",
-			"#rel2abs": "rel2abs",
-			"#titleparts": "titleparts",
-			"#categorytree": "categorytree",
-			"#urldecode": "urldecode",
-			"#choose": "choose",
-			"#var": "var",
-			"#varexists": "varexists",
-			"#var_final": "var_final",
-			"#vardefine": "vardefine",
-			"#vardefineecho": "vardefineecho",
-			"#widget": "widget",
-			"#related": "related",
-			"#cscore": "cscore"
-		},
-		[],
-		[
-			"msg",
-			"原始",
-			"raw"
-		],
-		[
-			"替代",
-			"subst",
-			"安全替代",
-			"safesubst"
-		]
-	],
-	"doubleUnderscore": [
-		[],
-		[]
-	],
-	"protocol": "bitcoin:|ftp://|ftps://|geo:|git://|gopher://|http://|https://|irc://|ircs://|magnet:|mailto:|mms://|news:|nntp://|redis://|sftp://|sip:|sips:|sms:|ssh://|svn://|tel:|telnet://|urn:|worldwind://|xmpp:",
-	"interwiki": [],
-	"img": {},
-	"variants": [
-		"zh",
-		"zh-hans",
-		"zh-hant",
-		"zh-cn",
-		"zh-tw",
-		"zh-hk",
-		"zh-sg",
-		"zh-my",
-		"zh-mo"
-	]
-}