-
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
// SPDX-FileCopyrightText: 2024 Shota FUJI <pockawoooh@gmail.com>
//
// SPDX-License-Identifier: Apache-2.0
import type * as Mdast from "../../deps/esm.sh/mdast/types.ts";
import { visit } from "../../deps/esm.sh/unist-util-visit/mod.ts";
import type { DocumentToken } from "../../types.ts";
import type { OfmWikilink } from "./mdast_util_ofm_wikilink.ts";
function hasDocumentToken(
node: Mdast.Node,
): node is typeof node & { data: { macanaDocumentToken: DocumentToken } } {
return !!(node.data && ("macanaDocumentToken" in node.data) &&
typeof node.data.macanaDocumentToken === "string" &&
node.data.macanaDocumentToken.startsWith("mxt_"));
}
export interface ExchangeResult {
/**
* Path string appears on the final markup.
*/
path: string;
}
function replace(
node: Mdast.Nodes | OfmWikilink,
{ path }: ExchangeResult,
): void {
switch (node.type) {
case "ofmWikilink": {
// Do not use resolved path as a fallback label
node.label ??= node.target;
node.target = path;
return;
}
case "link": {
node.url = path;
return;
}
case "definition": {
node.url = path;
return;
}
}
}
/**
* Modifies the given Mdast tree by searching nodes having `macanaDocumentToken`
* property then replacing node properties.
* This function modifies Mdast tree in place.
*
* @param tree - Mdast tree to modify.
* @param exchange - A function that takes Document Token and returns properties required for constructing markup.
*/
export function macanaReplaceDocumentToken(
tree: Mdast.Nodes,
exchange: (token: DocumentToken) => ExchangeResult | Promise<ExchangeResult>,
): Promise<void> | void {
const promises: Promise<unknown>[] = [];
visit(
tree,
(node) => hasDocumentToken(node),
(node) => {
if (!hasDocumentToken(node)) {
return;
}
const exchanged = exchange(node.data.macanaDocumentToken);
if (exchanged instanceof Promise) {
promises.push(exchanged.then((payload) => {
replace(node, payload);
}));
return;
}
replace(node, exchanged);
},
);
if (promises.length > 0) {
return Promise.all(promises).then(() => {});
}
}