add support for additional link modes

Author: shibaobun

.tool-versions

@@ -0,0 +1 @@
+nodejs 16.13.2

CHANGELOG.md

@@ -10,6 +10,11 @@
 ### Bugfixes
 
 -->
+## 0.24.0
+
+### Features
+- Add Remote media syntax for links (#127)
+
 ## 0.23.1
 
 ### Improvements

docs/syntax.md

@@ -535,20 +535,29 @@ http://hoge.jp/abc
 <h1 id="link">Inline: リンク</h2>
 
 ## 形式
-silent=false
+type='plain'
 ```
 [Misskey.io](https://misskey.io/)
 ```
 
-silent=true
+type='plain' with special characters
+```
+[#藍ちゃファンクラブ](<https://misskey.io/explore/tags/藍ちゃファンクラブ>)
+```
+
+type='silent'
 ```
 ?[Misskey.io](https://misskey.io/)
 ```
 
+type='embed'
+```
+![Misskey.io](https://misskey.io/)
+```
+
 Special characters
 ```
 [#藍ちゃファンクラブ](<https://misskey.io/explore/tags/藍ちゃファンクラブ>)
-```
 
 ## 詳細
 - リンクラベルには再度InlineParserを適用する。ただし、リンクラベルではURL、リンク、メンションは使用できない。
@@ -559,7 +568,7 @@ Special characters
   {
     type: 'link',
     props: {
-      silent: false,
+      type: 'plain'
       url: {
         type: 'url',
         props: {

etc/mfm-js.api.md

@@ -38,7 +38,7 @@ export function inspect(nodes: MfmNode[], action: (node: MfmNode) => void): void
 export const ITALIC: (children: MfmInline[]) => NodeType<'italic'>;
 
 // @public (undocumented)
-export const LINK: (silent: boolean, url: MfmUrl, children: MfmInline[]) => NodeType<'link'>;
+export const LINK: (type: 'plain' | 'silent' | 'embed', url: MfmUrl, children: MfmInline[]) => NodeType<'link'>;
 
 // @public (undocumented)
 export const MATH_BLOCK: (formula: string) => NodeType<'mathBlock'>;
@@ -127,7 +127,7 @@ export type MfmItalic = {
 export type MfmLink = {
     type: 'link';
     props: {
-        silent: boolean;
+        type: 'plain' | 'silent' | 'embed';
         url: MfmUrl;
     };
     children: MfmInline[];

package.json

@@ -1,6 +1,6 @@
 {
   "name": "mfm-js",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "description": "An MFM parser implementation with TypeScript",
   "main": "./built/index.js",
   "types": "./built/index.d.ts",

src/internal/parser.ts

@@ -465,7 +465,7 @@ export const language = P.createLanguage({
 			P.str('.'),
 			arg.sep(P.str(','), 1),
 		], 1).map(pairs => {
-			const result: Args = { };
+			const result: Args = {};
 			for (const pair of pairs) {
 				result[pair.k] = pair.v;
 			}
@@ -644,7 +644,7 @@ export const language = P.createLanguage({
 		const closeLabel = P.str(']');
 		return P.seq([
 			notLinkLabel,
-			P.alt([P.str('?['), P.str('[')]),
+			P.alt([P.str('?['), P.str('!['), P.str('[')]),
 			P.seq([
 				P.notMatch(P.alt([closeLabel, newLine])),
 				nest(labelInline),
@@ -654,10 +654,15 @@ export const language = P.createLanguage({
 			P.alt([r.urlAlt, r.url]),
 			P.str(')'),
 		]).map(result => {
-			const silent = (result[1] === '?[');
+			const mapping: {[key: string]: M.MfmLink['props']['type']} = {
+				'?[': 'silent',
+				'![': 'embed',
+				'[': 'plain',
+			};
+			const type: M.MfmLink['props']['type'] = mapping[result[1]];
 			const label = result[2];
 			const url: M.MfmUrl = result[5];
-			return M.LINK(silent, url, mergeText(label));
+			return M.LINK(type, url, mergeText(label));
 		});
 	},
 

src/internal/util.ts

@@ -1,4 +1,4 @@
-import { isMfmBlock, MfmInline, MfmNode, MfmText, TEXT } from '../node';
+import { isMfmBlock, MfmInline, MfmNode, MfmText, MfmLink, TEXT } from '../node';
 
 export function mergeText<T extends MfmNode>(nodes: ((T extends MfmInline ? MfmInline : MfmNode) | string)[]): (T | MfmText)[] {
 	const dest: (T | MfmText)[] = [];
@@ -91,8 +91,12 @@ export function stringifyNode(node: MfmNode): string {
 			}
 		}
 		case 'link': {
-			const prefix = node.props.silent ? '?' : '';
-			return `${ prefix }[${ stringifyTree(node.children) }](${ stringifyNode(node.props.url) })`;
+			const prefixMapping: {[key in MfmLink['props']['type']]: string} = {
+				'silent': '?',
+				'embed': '!',
+				'plain': '',
+			};
+			return `${ prefixMapping[node.props.type] }[${ stringifyTree(node.children) }](${ stringifyNode(node.props.url) })`;
 		}
 		case 'fn': {
 			const argFields = Object.keys(node.props.args).map(key => {

src/node.ts

@@ -156,12 +156,12 @@ export const N_URL = (value: string, brackets?: boolean): NodeType<'url'> => {
 export type MfmLink = {
 	type: 'link';
 	props: {
-		silent: boolean;
+		type: 'plain' | 'silent' | 'embed';
 		url: MfmUrl;
 	};
 	children: MfmInline[];
 };
-export const LINK = (silent: boolean, url: MfmUrl, children: MfmInline[]): NodeType<'link'> => { return { type: 'link', props: { silent, url }, children }; };
+export const LINK = (type: 'plain' | 'silent' | 'embed', url: MfmUrl, children: MfmInline[]): NodeType<'link'> => { return { type: 'link', props: { type, url }, children }; };
 
 export type MfmFn = {
 	type: 'fn';

test/api.ts

@@ -142,6 +142,11 @@ after`;
 			assert.strictEqual(mfm.toString(mfm.parse(input)), '?[Ai](https://github.com/syuilo/ai)');
 		});
 
+		it('image link', () => {
+			const input = '![Ai logo](https://raw.githubusercontent.com/syuilo/ai/master/ai.svg)';
+			assert.strictEqual(mfm.toString(mfm.parse(input)), '![Ai logo](https://raw.githubusercontent.com/syuilo/ai/master/ai.svg)');
+		});
+
 		it('fn', () => {
 			const input = '$[tada Hello]';
 			assert.strictEqual(mfm.toString(mfm.parse(input)), '$[tada Hello]');

test/parser.ts

@@ -1023,7 +1023,7 @@ hoge`;
 			const input = '[official instance](https://misskey.io/@ai).';
 			const output = [
 				LINK(
-					false,
+					'plain',
 					N_URL('https://misskey.io/@ai'),
 					[TEXT('official instance')]
 				),
@@ -1036,7 +1036,7 @@ hoge`;
 			const input = '?[official instance](https://misskey.io/@ai).';
 			const output = [
 				LINK(
-					true,
+					'silent',
 					N_URL('https://misskey.io/@ai'),
 					[TEXT('official instance')]
 				),
@@ -1049,7 +1049,7 @@ hoge`;
 			const input = '[#藍ちゃファンクラブ](<https://misskey.io/explore/tags/藍ちゃファンクラブ>).';
 			const output = [
 				LINK(
-					false,
+					'plain',
 					N_URL('https://misskey.io/explore/tags/藍ちゃファンクラブ', true),
 					[TEXT('#藍ちゃファンクラブ')]
 				),
@@ -1058,13 +1058,52 @@ hoge`;
 			assert.deepStrictEqual(mfm.parse(input), output);
 		});
 
+		it('embed flag', () => {
+			const input = '![image](https://raw.githubusercontent.com/syuilo/ai/master/ai.svg).';
+			const output = [
+				LINK(
+					'embed',
+					N_URL('https://raw.githubusercontent.com/syuilo/ai/master/ai.svg'),
+					[TEXT('image')]
+				),
+				TEXT('.')
+			];
+			assert.deepStrictEqual(mfm.parse(input), output);
+		});
+
+		it('with angle brackets silent url', () => {
+			const input = '?[image](<https://raw.githubusercontent.com/syuilo/ai/master/ai.svg>).';
+			const output = [
+				LINK(
+					'silent',
+					N_URL('https://raw.githubusercontent.com/syuilo/ai/master/ai.svg', true),
+					[TEXT('image')]
+				),
+				TEXT('.')
+			];
+			assert.deepStrictEqual(mfm.parse(input), output);
+		});
+
+		it('with angle brackets embed url', () => {
+			const input = '![image](<https://raw.githubusercontent.com/syuilo/ai/master/ai.svg>).';
+			const output = [
+				LINK(
+					'embed',
+					N_URL('https://raw.githubusercontent.com/syuilo/ai/master/ai.svg', true),
+					[TEXT('image')]
+				),
+				TEXT('.')
+			];
+			assert.deepStrictEqual(mfm.parse(input), output);
+		});
+
 		describe('cannot nest a url in a link label', () => {
 			it('basic', () => {
 				const input = 'official instance: [https://misskey.io/@ai](https://misskey.io/@ai).';
 				const output = [
 					TEXT('official instance: '),
 					LINK(
-						false,
+						'plain',
 						N_URL('https://misskey.io/@ai'),
 						[TEXT('https://misskey.io/@ai')]
 					),
@@ -1077,7 +1116,7 @@ hoge`;
 				const output = [
 					TEXT('official instance: '),
 					LINK(
-						false,
+						'plain',
 						N_URL('https://misskey.io/@ai'),
 						[
 							TEXT('https://misskey.io/@ai'),
@@ -1098,7 +1137,7 @@ hoge`;
 				const output = [
 					TEXT('official instance: '),
 					LINK(
-						false,
+						'plain',
 						N_URL('https://misskey.io/@ai'),
 						[TEXT('[https://misskey.io/@ai')]
 					),
@@ -1113,7 +1152,7 @@ hoge`;
 				const output = [
 					TEXT('official instance: '),
 					LINK(
-						false,
+						'plain',
 						N_URL('https://misskey.io/@ai'),
 						[
 							BOLD([
@@ -1131,7 +1170,7 @@ hoge`;
 				const input = '[@example](https://example.com)';
 				const output = [
 					LINK(
-						false,
+						'plain',
 						N_URL('https://example.com'),
 						[TEXT('@example')]
 					),
@@ -1142,7 +1181,7 @@ hoge`;
 				const input = '[@example**@example**](https://example.com)';
 				const output = [
 					LINK(
-						false,
+						'plain',
 						N_URL('https://example.com'),
 						[
 							TEXT('@example'),
@@ -1160,7 +1199,7 @@ hoge`;
 			const input = '[foo](https://example.com/foo(bar))';
 			const output = [
 				LINK(
-					false,
+					'plain',
 					N_URL('https://example.com/foo(bar)'),
 					[TEXT('foo')]
 				),
@@ -1173,7 +1212,7 @@ hoge`;
 			const output = [
 				TEXT('('),
 				LINK(
-					false,
+					'plain',
 					N_URL('https://example.com/foo(bar)'),
 					[TEXT('foo')]
 				),
@@ -1187,7 +1226,7 @@ hoge`;
 			const output = [
 				TEXT('[test] foo '),
 				LINK(
-					false,
+					'plain',
 					N_URL('https://example.com'),
 					[TEXT('bar')]
 				),