@vuepress/core 2.0.0-rc.3 → 2.0.0-rc.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/index.d.ts +559 -640
- package/dist/index.js +988 -982
- package/package.json +25 -30
package/dist/index.js
CHANGED
|
@@ -1,1017 +1,1023 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
1
|
+
import { createRequire } from "node:module";
|
|
2
|
+
import { ensureLeadingSlash, formatDateString, inferRoutePath, isFunction, isString, normalizeRoutePath, omit, removeLeadingSlash, resolveLocalePath } from "@vuepress/shared";
|
|
3
|
+
import { colors, debug, fs, hash, logger, path, sanitizeFileName, templateRenderer, tinyglobby, transformPathToFileName, warn } from "@vuepress/utils";
|
|
4
|
+
import { createMarkdown } from "@vuepress/markdown";
|
|
5
|
+
//#region src/app/prepare/prepareClientConfigs.ts
|
|
6
|
+
/**
|
|
7
|
+
* Generate client configs temp file
|
|
8
|
+
*
|
|
9
|
+
* @internal
|
|
10
|
+
*/
|
|
11
|
+
const prepareClientConfigs = async (app) => {
|
|
12
|
+
const clientConfigFiles = await app.pluginApi.hooks.clientConfigFile.process(app);
|
|
13
|
+
const content = `\
|
|
14
|
+
${clientConfigFiles.map((filePath, index) => `import * as clientConfig${index} from '${filePath}'`).join("\n")}
|
|
5
15
|
|
|
6
16
|
export const clientConfigs = [
|
|
7
17
|
${clientConfigFiles.map((_, index) => ` clientConfig${index},`).join("\n")}
|
|
8
|
-
]
|
|
18
|
+
].map((m) => m.default).filter(Boolean)
|
|
9
19
|
`;
|
|
10
|
-
|
|
11
|
-
};
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
20
|
+
await app.writeTemp("internal/clientConfigs.js", content);
|
|
21
|
+
};
|
|
22
|
+
//#endregion
|
|
23
|
+
//#region src/page/inferPagePath.ts
|
|
24
|
+
/**
|
|
25
|
+
* Infer page path according to file path
|
|
26
|
+
*
|
|
27
|
+
* @internal
|
|
28
|
+
*/
|
|
29
|
+
const inferPagePath = ({ app, filePathRelative, options }) => {
|
|
30
|
+
if (options.path) {
|
|
31
|
+
const pathLocale = resolveLocalePath(app.siteData.locales, options.path);
|
|
32
|
+
return {
|
|
33
|
+
pathInferred: filePathRelative ? inferRoutePath(ensureLeadingSlash(filePathRelative)) : null,
|
|
34
|
+
pathLocale
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
if (!filePathRelative) return {
|
|
38
|
+
pathInferred: null,
|
|
39
|
+
pathLocale: "/"
|
|
40
|
+
};
|
|
41
|
+
const pathInferred = inferRoutePath(ensureLeadingSlash(filePathRelative));
|
|
42
|
+
return {
|
|
43
|
+
pathInferred,
|
|
44
|
+
pathLocale: resolveLocalePath(app.siteData.locales, pathInferred)
|
|
45
|
+
};
|
|
46
|
+
};
|
|
47
|
+
//#endregion
|
|
48
|
+
//#region src/page/parsePageContent.ts
|
|
49
|
+
/**
|
|
50
|
+
* Render page content and extract related info
|
|
51
|
+
*
|
|
52
|
+
* @internal
|
|
53
|
+
*/
|
|
54
|
+
const parsePageContent = ({ app, content, filePath, filePathRelative, options }) => {
|
|
55
|
+
const markdownEnv = {
|
|
56
|
+
base: app.options.base,
|
|
57
|
+
filePath,
|
|
58
|
+
filePathRelative,
|
|
59
|
+
frontmatter: { ...options.frontmatter }
|
|
60
|
+
};
|
|
61
|
+
const contentRendered = app.markdown.render(content, markdownEnv);
|
|
62
|
+
/* istanbul ignore next */
|
|
63
|
+
const { frontmatter = {}, headers = [], importedFiles = [], links = [], sfcBlocks = {
|
|
64
|
+
template: null,
|
|
65
|
+
script: null,
|
|
66
|
+
scriptSetup: null,
|
|
67
|
+
scripts: [],
|
|
68
|
+
styles: [],
|
|
69
|
+
customBlocks: []
|
|
70
|
+
}, title = "", ...extraMarkdownEnv } = markdownEnv;
|
|
71
|
+
return {
|
|
72
|
+
contentRendered,
|
|
73
|
+
deps: importedFiles,
|
|
74
|
+
frontmatter,
|
|
75
|
+
headers,
|
|
76
|
+
links,
|
|
77
|
+
markdownEnv: omit(extraMarkdownEnv, "base", "content", "filePath", "filePathRelative", "frontmatter"),
|
|
78
|
+
sfcBlocks,
|
|
79
|
+
title: frontmatter.title ? `${frontmatter.title}` : title
|
|
80
|
+
};
|
|
81
|
+
};
|
|
82
|
+
//#endregion
|
|
83
|
+
//#region src/page/resolvePageChunkInfo.ts
|
|
84
|
+
/**
|
|
85
|
+
* Resolve page chunk file related info
|
|
86
|
+
*
|
|
87
|
+
* @internal
|
|
88
|
+
*/
|
|
89
|
+
const resolvePageChunkInfo = ({ app, filePath, filePathRelative, htmlFilePathRelative }) => {
|
|
90
|
+
const chunkName = transformPathToFileName(htmlFilePathRelative);
|
|
91
|
+
if (filePath && filePathRelative) return {
|
|
92
|
+
chunkFilePath: filePath,
|
|
93
|
+
chunkFilePathRelative: filePathRelative,
|
|
94
|
+
chunkName
|
|
95
|
+
};
|
|
96
|
+
const chunkFilePathRelative = path.join("pages", `${htmlFilePathRelative}.vue`);
|
|
97
|
+
return {
|
|
98
|
+
chunkFilePath: app.dir.temp(chunkFilePathRelative),
|
|
99
|
+
chunkFilePathRelative,
|
|
100
|
+
chunkName
|
|
101
|
+
};
|
|
102
|
+
};
|
|
103
|
+
//#endregion
|
|
104
|
+
//#region src/page/resolvePageContent.ts
|
|
105
|
+
const log$5 = debug("vuepress:core/page");
|
|
106
|
+
const FALLBACK_CONTENT = "";
|
|
107
|
+
/**
|
|
108
|
+
* Resolve page content according to `content` or `filePath`
|
|
109
|
+
*
|
|
110
|
+
* @internal
|
|
111
|
+
*/
|
|
112
|
+
const resolvePageContent = async ({ filePath, options }) => {
|
|
113
|
+
if (isString(options.content)) return options.content;
|
|
114
|
+
if (filePath) try {
|
|
115
|
+
return await fs.readFile(filePath, "utf-8");
|
|
116
|
+
} catch (e) {
|
|
117
|
+
log$5(e instanceof Error ? e.message : e);
|
|
118
|
+
}
|
|
119
|
+
return FALLBACK_CONTENT;
|
|
120
|
+
};
|
|
121
|
+
//#endregion
|
|
122
|
+
//#region src/page/resolvePageDate.ts
|
|
123
|
+
const FILENAME_DATE_RE = /^(\d{4})-(\d{1,2})(?:-(\d{1,2}))?-(.*)$/;
|
|
124
|
+
const DIRNAME_DATE_RE = /(\d{4})\/(\d{1,2})(?:\/(\d{1,2}))?(\/|$)/;
|
|
125
|
+
const DEFAULT_DATE = "0000-00-00";
|
|
126
|
+
/**
|
|
127
|
+
* Resolve page date according to frontmatter or file path
|
|
128
|
+
*
|
|
129
|
+
* It will be resolved as 'yyyy-MM-dd' format
|
|
130
|
+
*
|
|
131
|
+
* @internal
|
|
132
|
+
*/
|
|
133
|
+
const resolvePageDate = ({ frontmatter, filePathRelative }) => {
|
|
134
|
+
if (frontmatter.date instanceof Date) return formatDateString([
|
|
135
|
+
frontmatter.date.getUTCFullYear(),
|
|
136
|
+
frontmatter.date.getUTCMonth() + 1,
|
|
137
|
+
frontmatter.date.getUTCDate()
|
|
138
|
+
].join("-"), DEFAULT_DATE);
|
|
139
|
+
if (isString(frontmatter.date)) return formatDateString(frontmatter.date, DEFAULT_DATE);
|
|
140
|
+
if (filePathRelative === null) return DEFAULT_DATE;
|
|
141
|
+
const filename = path.parse(filePathRelative).name;
|
|
142
|
+
if (filename) {
|
|
143
|
+
const matches = filename.match(FILENAME_DATE_RE);
|
|
144
|
+
if (matches) return formatDateString(`${matches[1]}-${matches[2]}-${matches[3] ?? "01"}`, DEFAULT_DATE);
|
|
145
|
+
}
|
|
146
|
+
const dirname = path.dirname(filePathRelative);
|
|
147
|
+
if (dirname !== ".") {
|
|
148
|
+
const matches = dirname.match(DIRNAME_DATE_RE);
|
|
149
|
+
if (matches) return formatDateString(`${matches[1]}-${matches[2]}-${matches[3] ?? "01"}`, DEFAULT_DATE);
|
|
150
|
+
}
|
|
151
|
+
return DEFAULT_DATE;
|
|
152
|
+
};
|
|
153
|
+
//#endregion
|
|
154
|
+
//#region src/page/resolvePageFilePath.ts
|
|
155
|
+
/**
|
|
156
|
+
* Resolve absolute and relative path of page file
|
|
157
|
+
*
|
|
158
|
+
* @internal
|
|
159
|
+
*/
|
|
160
|
+
const resolvePageFilePath = ({ app, options }) => {
|
|
161
|
+
if (!options.filePath) return {
|
|
162
|
+
filePath: null,
|
|
163
|
+
filePathRelative: null
|
|
164
|
+
};
|
|
165
|
+
if (!path.isAbsolute(options.filePath)) throw logger.createError(`filePath is not absolute file path: ${options.filePath}}`);
|
|
166
|
+
return {
|
|
167
|
+
filePath: options.filePath,
|
|
168
|
+
filePathRelative: path.relative(app.dir.source(), options.filePath)
|
|
169
|
+
};
|
|
170
|
+
};
|
|
171
|
+
//#endregion
|
|
172
|
+
//#region src/page/resolvePageHtmlInfo.ts
|
|
173
|
+
/**
|
|
174
|
+
* Resolve page rendered html file path
|
|
175
|
+
*
|
|
176
|
+
* @internal
|
|
177
|
+
*/
|
|
178
|
+
const resolvePageHtmlInfo = ({ app, path: pagePath }) => {
|
|
179
|
+
const path = decodeURI(pagePath);
|
|
180
|
+
const htmlFilePathRelative = removeLeadingSlash(path.endsWith("/") ? `${path}index.html` : path.endsWith(".html") ? path : `${path}.html`);
|
|
181
|
+
return {
|
|
182
|
+
htmlFilePath: app.dir.dest(htmlFilePathRelative),
|
|
183
|
+
htmlFilePathRelative
|
|
184
|
+
};
|
|
185
|
+
};
|
|
186
|
+
//#endregion
|
|
187
|
+
//#region src/page/resolvePageLang.ts
|
|
188
|
+
/**
|
|
189
|
+
* Resolve language of page
|
|
190
|
+
*
|
|
191
|
+
* @internal
|
|
192
|
+
*/
|
|
193
|
+
const resolvePageLang = ({ app, frontmatter, pathLocale }) => {
|
|
194
|
+
if (isString(frontmatter.lang) && frontmatter.lang) return frontmatter.lang;
|
|
195
|
+
return app.siteData.locales[pathLocale]?.lang ?? app.siteData.lang;
|
|
196
|
+
};
|
|
197
|
+
//#endregion
|
|
198
|
+
//#region src/page/resolvePagePath.ts
|
|
199
|
+
/**
|
|
200
|
+
* Resolve the final route path of a page
|
|
201
|
+
*
|
|
202
|
+
* @internal
|
|
203
|
+
*/
|
|
204
|
+
const resolvePagePath = ({ permalink, pathInferred, options }) => {
|
|
205
|
+
const pagePath = options.path || permalink || pathInferred;
|
|
206
|
+
if (!pagePath) throw logger.createError(`page path is empty, page options: ${JSON.stringify(options, null, 2)}`);
|
|
207
|
+
return encodeURI(pagePath.split("/").map(sanitizeFileName).join("/"));
|
|
208
|
+
};
|
|
209
|
+
//#endregion
|
|
210
|
+
//#region src/page/resolvePagePermalink.ts
|
|
211
|
+
/**
|
|
212
|
+
* Resolve page permalink from frontmatter / options / pattern
|
|
213
|
+
*
|
|
214
|
+
* @internal
|
|
215
|
+
*/
|
|
216
|
+
const resolvePagePermalink = ({ app, frontmatter, slug, date, pathInferred, pathLocale }) => {
|
|
217
|
+
if (frontmatter.permalink === null) return null;
|
|
218
|
+
if (isString(frontmatter.permalink)) return frontmatter.permalink;
|
|
219
|
+
if (frontmatter.permalinkPattern === null) return null;
|
|
220
|
+
const permalinkPattern = frontmatter.permalinkPattern || app.options.permalinkPattern;
|
|
221
|
+
if (!isString(permalinkPattern)) return null;
|
|
222
|
+
const [year, month, day] = date.split("-");
|
|
223
|
+
return ensureLeadingSlash(path.join(pathLocale, permalinkPattern.replace(/:year/, year).replace(/:month/, month).replace(/:day/, day).replace(/:slug/, slug).replace(/:raw/, pathInferred?.replace(/^\//, "") ?? "")));
|
|
224
|
+
};
|
|
225
|
+
//#endregion
|
|
226
|
+
//#region src/page/resolvePageRouteMeta.ts
|
|
227
|
+
/**
|
|
228
|
+
* Resolve page route meta
|
|
229
|
+
*
|
|
230
|
+
* @internal
|
|
231
|
+
*/
|
|
232
|
+
const resolvePageRouteMeta = ({ frontmatter }) => frontmatter.routeMeta ?? {};
|
|
233
|
+
//#endregion
|
|
234
|
+
//#region src/page/resolvePageSlug.ts
|
|
235
|
+
const DATE_RE = /(\d{4}-\d{1,2}(-\d{1,2})?)-(.*)/;
|
|
236
|
+
/**
|
|
237
|
+
* Resolve page slug from filename
|
|
238
|
+
*
|
|
239
|
+
* @internal
|
|
240
|
+
*/
|
|
241
|
+
const resolvePageSlug = ({ filePathRelative }) => {
|
|
242
|
+
if (!filePathRelative) return "";
|
|
243
|
+
const filename = path.parse(filePathRelative).name;
|
|
244
|
+
const match = filename.match(DATE_RE);
|
|
245
|
+
return match ? match[3] : filename;
|
|
246
|
+
};
|
|
247
|
+
//#endregion
|
|
248
|
+
//#region src/page/createPage.ts
|
|
249
|
+
/**
|
|
250
|
+
* Create vuepress page object
|
|
251
|
+
*/
|
|
252
|
+
const createPage = async (app, options) => {
|
|
253
|
+
await app.pluginApi.hooks.extendsPageOptions.process(options, app);
|
|
254
|
+
const { filePath, filePathRelative } = resolvePageFilePath({
|
|
255
|
+
app,
|
|
256
|
+
options
|
|
257
|
+
});
|
|
258
|
+
const content = await resolvePageContent({
|
|
259
|
+
filePath,
|
|
260
|
+
options
|
|
261
|
+
});
|
|
262
|
+
const { contentRendered, deps, frontmatter, headers, links, markdownEnv, sfcBlocks, title } = parsePageContent({
|
|
263
|
+
app,
|
|
264
|
+
content,
|
|
265
|
+
filePath,
|
|
266
|
+
filePathRelative,
|
|
267
|
+
options
|
|
268
|
+
});
|
|
269
|
+
const routeMeta = resolvePageRouteMeta({ frontmatter });
|
|
270
|
+
const slug = resolvePageSlug({ filePathRelative });
|
|
271
|
+
const date = resolvePageDate({
|
|
272
|
+
frontmatter,
|
|
273
|
+
filePathRelative
|
|
274
|
+
});
|
|
275
|
+
const { pathInferred, pathLocale } = inferPagePath({
|
|
276
|
+
app,
|
|
277
|
+
filePathRelative,
|
|
278
|
+
options
|
|
279
|
+
});
|
|
280
|
+
const lang = resolvePageLang({
|
|
281
|
+
app,
|
|
282
|
+
frontmatter,
|
|
283
|
+
pathLocale
|
|
284
|
+
});
|
|
285
|
+
const permalink = resolvePagePermalink({
|
|
286
|
+
app,
|
|
287
|
+
frontmatter,
|
|
288
|
+
slug,
|
|
289
|
+
date,
|
|
290
|
+
pathInferred,
|
|
291
|
+
pathLocale
|
|
292
|
+
});
|
|
293
|
+
const path = resolvePagePath({
|
|
294
|
+
permalink,
|
|
295
|
+
pathInferred,
|
|
296
|
+
options
|
|
297
|
+
});
|
|
298
|
+
const { htmlFilePath, htmlFilePathRelative } = resolvePageHtmlInfo({
|
|
299
|
+
app,
|
|
300
|
+
path
|
|
301
|
+
});
|
|
302
|
+
const { chunkFilePath, chunkFilePathRelative, chunkName } = resolvePageChunkInfo({
|
|
303
|
+
app,
|
|
304
|
+
filePath,
|
|
305
|
+
filePathRelative,
|
|
306
|
+
htmlFilePathRelative
|
|
307
|
+
});
|
|
308
|
+
const page = {
|
|
309
|
+
data: {
|
|
310
|
+
path,
|
|
311
|
+
title,
|
|
312
|
+
lang,
|
|
313
|
+
frontmatter
|
|
314
|
+
},
|
|
315
|
+
path,
|
|
316
|
+
title,
|
|
317
|
+
lang,
|
|
318
|
+
frontmatter,
|
|
319
|
+
headers,
|
|
320
|
+
content,
|
|
321
|
+
contentRendered,
|
|
322
|
+
date,
|
|
323
|
+
deps,
|
|
324
|
+
links,
|
|
325
|
+
markdownEnv,
|
|
326
|
+
pathInferred,
|
|
327
|
+
pathLocale,
|
|
328
|
+
permalink,
|
|
329
|
+
routeMeta,
|
|
330
|
+
sfcBlocks,
|
|
331
|
+
slug,
|
|
332
|
+
filePath,
|
|
333
|
+
filePathRelative,
|
|
334
|
+
chunkFilePath,
|
|
335
|
+
chunkFilePathRelative,
|
|
336
|
+
chunkName,
|
|
337
|
+
htmlFilePath,
|
|
338
|
+
htmlFilePathRelative
|
|
339
|
+
};
|
|
340
|
+
await app.pluginApi.hooks.extendsPage.process(page, app);
|
|
341
|
+
return page;
|
|
342
|
+
};
|
|
343
|
+
//#endregion
|
|
344
|
+
//#region src/page/renderPageToVue.ts
|
|
345
|
+
const TEMPLATE_WRAPPER_TAG_OPEN = "<div>";
|
|
346
|
+
const TEMPLATE_WRAPPER_TAG_CLOSE = "</div>";
|
|
347
|
+
const SCRIPT_TAG_OPEN = "<script>";
|
|
348
|
+
const SCRIPT_TAG_CLOSE = "<\/script>";
|
|
349
|
+
const SCRIPT_TAG_OPEN_LANG_TS_REGEX = /<\s*script[^>]*\blang=['"]ts['"][^>]*/;
|
|
350
|
+
const SCRIPT_TAG_OPEN_LANG_TS = "<script lang=\"ts\">";
|
|
351
|
+
const SCRIPT_DEFAULT_EXPORT_REGEX = /((?:^|\n|;)\s*)export(\s*)default/;
|
|
352
|
+
const SCRIPT_DEFAULT_NAMED_EXPORT_REGEX = /((?:^|\n|;)\s*)export(.+)as(\s*)default/;
|
|
353
|
+
const SCRIPT_DEFAULT_EXPORT_CODE_TEMPLATE_OUTLET = "__SCRIPT_DEFAULT_EXPORT__";
|
|
354
|
+
const SCRIPT_DEFAULT_EXPORT_CODE_TEMPLATE = `export default { name: ${SCRIPT_DEFAULT_EXPORT_CODE_TEMPLATE_OUTLET} }`;
|
|
355
|
+
const PAGE_DATA_CODE_VAR_NAME = "_pageData";
|
|
356
|
+
const PAGE_DATA_CODE_TEMPLATE_OUTLET = "__PAGE_DATA__";
|
|
357
|
+
const PAGE_DATA_CODE_TEMPLATE = `export const ${PAGE_DATA_CODE_VAR_NAME} = JSON.parse(${PAGE_DATA_CODE_TEMPLATE_OUTLET})`;
|
|
358
|
+
const HMR_CODE$2 = `
|
|
15
359
|
if (import.meta.webpackHot) {
|
|
16
360
|
import.meta.webpackHot.accept()
|
|
17
|
-
|
|
18
|
-
__VUE_HMR_RUNTIME__.updatePageData(data)
|
|
19
|
-
}
|
|
361
|
+
__VUE_HMR_RUNTIME__.updatePageData?.(${PAGE_DATA_CODE_VAR_NAME})
|
|
20
362
|
}
|
|
21
363
|
|
|
22
364
|
if (import.meta.hot) {
|
|
23
|
-
import.meta.hot.accept((
|
|
24
|
-
__VUE_HMR_RUNTIME__.updatePageData(
|
|
365
|
+
import.meta.hot.accept((m) => {
|
|
366
|
+
__VUE_HMR_RUNTIME__.updatePageData?.(m.${PAGE_DATA_CODE_VAR_NAME})
|
|
25
367
|
})
|
|
26
368
|
}
|
|
27
369
|
`;
|
|
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
|
-
|
|
370
|
+
/**
|
|
371
|
+
* Util to resolve the open tag of script block
|
|
372
|
+
*/
|
|
373
|
+
const resolveScriptTagOpen = (page) => {
|
|
374
|
+
if (page.sfcBlocks.script?.tagOpen) return page.sfcBlocks.script.tagOpen;
|
|
375
|
+
return page.sfcBlocks.scriptSetup?.tagOpen.match(SCRIPT_TAG_OPEN_LANG_TS_REGEX) ? SCRIPT_TAG_OPEN_LANG_TS : SCRIPT_TAG_OPEN;
|
|
376
|
+
};
|
|
377
|
+
/**
|
|
378
|
+
* Util to resolve the default export code
|
|
379
|
+
*/
|
|
380
|
+
const resolveDefaultExportCode = (page) => SCRIPT_DEFAULT_EXPORT_CODE_TEMPLATE.replace(SCRIPT_DEFAULT_EXPORT_CODE_TEMPLATE_OUTLET, JSON.stringify(path.basename(page.chunkFilePath)));
|
|
381
|
+
/**
|
|
382
|
+
* Util to resolve the page data code
|
|
383
|
+
*/
|
|
384
|
+
const resolvePageDataCode = (page) => PAGE_DATA_CODE_TEMPLATE.replace(PAGE_DATA_CODE_TEMPLATE_OUTLET, JSON.stringify(JSON.stringify(page.data)));
|
|
385
|
+
/**
|
|
386
|
+
* Resolve the stripped content of script block
|
|
387
|
+
*/
|
|
388
|
+
const resolveScriptContentStripped = (app, page) => {
|
|
389
|
+
const rawContentStripped = page.sfcBlocks.script?.contentStripped;
|
|
390
|
+
const hasDefaultExport = rawContentStripped ? SCRIPT_DEFAULT_EXPORT_REGEX.test(rawContentStripped) || SCRIPT_DEFAULT_NAMED_EXPORT_REGEX.test(rawContentStripped) : false;
|
|
391
|
+
return [
|
|
392
|
+
rawContentStripped,
|
|
393
|
+
resolvePageDataCode(page),
|
|
394
|
+
!hasDefaultExport && resolveDefaultExportCode(page),
|
|
395
|
+
app.env.isDev && HMR_CODE$2
|
|
396
|
+
].filter(isString).join("\n");
|
|
397
|
+
};
|
|
398
|
+
/**
|
|
399
|
+
* Render page to vue component
|
|
400
|
+
*/
|
|
401
|
+
const renderPageToVue = (app, page) => {
|
|
402
|
+
const { sfcBlocks } = page;
|
|
403
|
+
return [
|
|
404
|
+
sfcBlocks.template && [
|
|
405
|
+
sfcBlocks.template.tagOpen,
|
|
406
|
+
TEMPLATE_WRAPPER_TAG_OPEN,
|
|
407
|
+
sfcBlocks.template.contentStripped,
|
|
408
|
+
TEMPLATE_WRAPPER_TAG_CLOSE,
|
|
409
|
+
sfcBlocks.template.tagClose
|
|
410
|
+
].join(""),
|
|
411
|
+
[
|
|
412
|
+
resolveScriptTagOpen(page),
|
|
413
|
+
resolveScriptContentStripped(app, page),
|
|
414
|
+
sfcBlocks.script?.tagClose ?? SCRIPT_TAG_CLOSE
|
|
415
|
+
].filter(isString).join("\n"),
|
|
416
|
+
sfcBlocks.scriptSetup?.content,
|
|
417
|
+
...sfcBlocks.styles.map((item) => item.content),
|
|
418
|
+
...sfcBlocks.customBlocks.map((item) => item.content)
|
|
419
|
+
].filter(isString).join("\n");
|
|
420
|
+
};
|
|
421
|
+
//#endregion
|
|
422
|
+
//#region src/app/prepare/preparePageChunk.ts
|
|
423
|
+
/**
|
|
424
|
+
* Generate temp file if the page does not have a source file
|
|
425
|
+
*/
|
|
426
|
+
const preparePageChunk = async (app, page) => {
|
|
427
|
+
if (page.filePath === null) await app.writeTemp(page.chunkFilePathRelative, renderPageToVue(app, page));
|
|
428
|
+
};
|
|
429
|
+
//#endregion
|
|
430
|
+
//#region src/app/prepare/prepareRoutes.ts
|
|
431
|
+
const ROUTES_VAR_NAME = "routes";
|
|
432
|
+
const REDIRECTS_VAR_NAME = "redirects";
|
|
433
|
+
const HMR_CODE$1 = `
|
|
59
434
|
if (import.meta.webpackHot) {
|
|
60
435
|
import.meta.webpackHot.accept()
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
}
|
|
64
|
-
if (__VUE_HMR_RUNTIME__.updateRedirects) {
|
|
65
|
-
__VUE_HMR_RUNTIME__.updateRedirects(redirects)
|
|
66
|
-
}
|
|
436
|
+
__VUE_HMR_RUNTIME__.updateRoutes?.(${ROUTES_VAR_NAME})
|
|
437
|
+
__VUE_HMR_RUNTIME__.updateRedirects?.(${REDIRECTS_VAR_NAME})
|
|
67
438
|
}
|
|
68
439
|
|
|
69
440
|
if (import.meta.hot) {
|
|
70
|
-
import.meta.hot.accept((
|
|
71
|
-
__VUE_HMR_RUNTIME__.updateRoutes(
|
|
72
|
-
__VUE_HMR_RUNTIME__.updateRedirects(
|
|
441
|
+
import.meta.hot.accept((m) => {
|
|
442
|
+
__VUE_HMR_RUNTIME__.updateRoutes?.(m.${ROUTES_VAR_NAME})
|
|
443
|
+
__VUE_HMR_RUNTIME__.updateRedirects?.(m.${REDIRECTS_VAR_NAME})
|
|
73
444
|
})
|
|
74
445
|
}
|
|
75
446
|
`;
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
}
|
|
99
|
-
var prepareRoutes = async (app) => {
|
|
100
|
-
let content = `export const redirects = JSON.parse(${JSON.stringify(
|
|
101
|
-
JSON.stringify(
|
|
102
|
-
Object.fromEntries(
|
|
103
|
-
app.pages.flatMap(
|
|
104
|
-
(page) => resolvePageRedirects(page).map((redirect) => [redirect, page.path])
|
|
105
|
-
)
|
|
106
|
-
)
|
|
107
|
-
)
|
|
108
|
-
)})
|
|
109
|
-
|
|
110
|
-
export const routes = Object.fromEntries([
|
|
111
|
-
${app.pages.map(
|
|
112
|
-
({ chunkFilePath, chunkName, path: path9, routeMeta }) => ` [${JSON.stringify(path9)}, { loader: () => import(${chunkName ? `/* webpackChunkName: "${chunkName}" */` : ""}${JSON.stringify(chunkFilePath)}), meta: ${JSON.stringify(routeMeta)} }],`
|
|
113
|
-
).join("\n")}
|
|
447
|
+
/**
|
|
448
|
+
* Resolve page redirects
|
|
449
|
+
*
|
|
450
|
+
* @internal
|
|
451
|
+
*/
|
|
452
|
+
const resolvePageRedirects = ({ path, pathInferred }) => {
|
|
453
|
+
const redirectsSet = /* @__PURE__ */ new Set();
|
|
454
|
+
if (pathInferred !== null) {
|
|
455
|
+
const normalizedPathInferred = normalizeRoutePath(pathInferred);
|
|
456
|
+
const encodedPathInferred = encodeURI(normalizedPathInferred);
|
|
457
|
+
if (normalizedPathInferred !== path && encodedPathInferred !== path) redirectsSet.add(encodedPathInferred);
|
|
458
|
+
}
|
|
459
|
+
return Array.from(redirectsSet);
|
|
460
|
+
};
|
|
461
|
+
/**
|
|
462
|
+
* Generate routes temp file
|
|
463
|
+
*/
|
|
464
|
+
const prepareRoutes = async (app) => {
|
|
465
|
+
let content = `\
|
|
466
|
+
export const ${REDIRECTS_VAR_NAME} = JSON.parse(${JSON.stringify(JSON.stringify(Object.fromEntries(app.pages.flatMap((page) => resolvePageRedirects(page).map((redirect) => [redirect, page.path])))))})
|
|
467
|
+
|
|
468
|
+
export const ${ROUTES_VAR_NAME} = Object.fromEntries([
|
|
469
|
+
${app.pages.map(({ chunkFilePath, chunkName, path, routeMeta }) => ` [${JSON.stringify(path)}, { loader: () => import(${chunkName ? `/* webpackChunkName: "${chunkName}" */` : ""}${JSON.stringify(chunkFilePath)}), meta: ${JSON.stringify(routeMeta)} }],`).join("\n")}
|
|
114
470
|
]);
|
|
115
471
|
`;
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
}
|
|
119
|
-
await app.writeTemp("internal/routes.js", content);
|
|
472
|
+
if (app.env.isDev) content += HMR_CODE$1;
|
|
473
|
+
await app.writeTemp("internal/routes.js", content);
|
|
120
474
|
};
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
475
|
+
//#endregion
|
|
476
|
+
//#region src/app/prepare/prepareSiteData.ts
|
|
477
|
+
const SITE_DATA_VAR_NAME = "siteData";
|
|
478
|
+
const HMR_CODE = `
|
|
124
479
|
if (import.meta.webpackHot) {
|
|
125
480
|
import.meta.webpackHot.accept()
|
|
126
|
-
|
|
127
|
-
__VUE_HMR_RUNTIME__.updateSiteData(siteData)
|
|
128
|
-
}
|
|
481
|
+
__VUE_HMR_RUNTIME__.updateSiteData?.(${SITE_DATA_VAR_NAME})
|
|
129
482
|
}
|
|
130
483
|
|
|
131
484
|
if (import.meta.hot) {
|
|
132
|
-
import.meta.hot.accept((
|
|
133
|
-
__VUE_HMR_RUNTIME__.updateSiteData(
|
|
485
|
+
import.meta.hot.accept((m) => {
|
|
486
|
+
__VUE_HMR_RUNTIME__.updateSiteData?.(m.${SITE_DATA_VAR_NAME})
|
|
134
487
|
})
|
|
135
488
|
}
|
|
136
489
|
`;
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
490
|
+
/**
|
|
491
|
+
* Generate site data temp file
|
|
492
|
+
*
|
|
493
|
+
* @internal
|
|
494
|
+
*/
|
|
495
|
+
const prepareSiteData = async (app) => {
|
|
496
|
+
let content = `\
|
|
497
|
+
export const ${SITE_DATA_VAR_NAME} = JSON.parse(${JSON.stringify(JSON.stringify(app.siteData))})
|
|
141
498
|
`;
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
}
|
|
354
|
-
return {
|
|
355
|
-
filePath: options.filePath,
|
|
356
|
-
filePathRelative: path4.relative(app.dir.source(), options.filePath)
|
|
357
|
-
};
|
|
358
|
-
};
|
|
359
|
-
|
|
360
|
-
// src/page/resolvePageHtmlInfo.ts
|
|
361
|
-
import { removeLeadingSlash } from "@vuepress/shared";
|
|
362
|
-
var resolvePageHtmlInfo = ({
|
|
363
|
-
app,
|
|
364
|
-
path: pagePath
|
|
365
|
-
}) => {
|
|
366
|
-
const path9 = decodeURI(pagePath);
|
|
367
|
-
const htmlFilePathRelative = removeLeadingSlash(
|
|
368
|
-
path9.endsWith("/") ? path9 + "index.html" : path9.endsWith(".html") ? path9 : path9 + ".html"
|
|
369
|
-
);
|
|
370
|
-
const htmlFilePath = app.dir.dest(htmlFilePathRelative);
|
|
371
|
-
return {
|
|
372
|
-
htmlFilePath,
|
|
373
|
-
htmlFilePathRelative
|
|
374
|
-
};
|
|
375
|
-
};
|
|
376
|
-
|
|
377
|
-
// src/page/resolvePageLang.ts
|
|
378
|
-
import { isString as isString2 } from "@vuepress/shared";
|
|
379
|
-
var resolvePageLang = ({
|
|
380
|
-
app,
|
|
381
|
-
frontmatter,
|
|
382
|
-
pathLocale
|
|
383
|
-
}) => {
|
|
384
|
-
if (isString2(frontmatter.lang) && frontmatter.lang) {
|
|
385
|
-
return frontmatter.lang;
|
|
386
|
-
}
|
|
387
|
-
return app.siteData.locales[pathLocale]?.lang ?? app.siteData.lang;
|
|
388
|
-
};
|
|
389
|
-
|
|
390
|
-
// src/page/resolvePagePath.ts
|
|
391
|
-
import { logger as logger2, sanitizeFileName } from "@vuepress/utils";
|
|
392
|
-
var resolvePagePath = ({
|
|
393
|
-
permalink,
|
|
394
|
-
pathInferred,
|
|
395
|
-
options
|
|
396
|
-
}) => {
|
|
397
|
-
const pagePath = options.path || permalink || pathInferred;
|
|
398
|
-
if (!pagePath) {
|
|
399
|
-
throw logger2.createError(
|
|
400
|
-
`page path is empty, page options: ${JSON.stringify(options, null, 2)}`
|
|
401
|
-
);
|
|
402
|
-
}
|
|
403
|
-
return encodeURI(pagePath.split("/").map(sanitizeFileName).join("/"));
|
|
404
|
-
};
|
|
405
|
-
|
|
406
|
-
// src/page/resolvePagePermalink.ts
|
|
407
|
-
import { ensureLeadingSlash as ensureLeadingSlash3, isString as isString3 } from "@vuepress/shared";
|
|
408
|
-
import { path as path5 } from "@vuepress/utils";
|
|
409
|
-
var resolvePagePermalink = ({
|
|
410
|
-
app,
|
|
411
|
-
frontmatter,
|
|
412
|
-
slug,
|
|
413
|
-
date,
|
|
414
|
-
pathInferred,
|
|
415
|
-
pathLocale
|
|
416
|
-
}) => {
|
|
417
|
-
if (isString3(frontmatter.permalink)) {
|
|
418
|
-
return frontmatter.permalink;
|
|
419
|
-
}
|
|
420
|
-
const permalinkPattern = getPermalinkPattern({ app, frontmatter });
|
|
421
|
-
if (permalinkPattern === null) {
|
|
422
|
-
return null;
|
|
423
|
-
}
|
|
424
|
-
const [year, month, day] = date.split("-");
|
|
425
|
-
const link = path5.join(
|
|
426
|
-
pathLocale,
|
|
427
|
-
permalinkPattern.replace(/:year/, year).replace(/:month/, month).replace(/:day/, day).replace(/:slug/, slug).replace(/:raw/, pathInferred?.replace(/^\//, "") ?? "")
|
|
428
|
-
);
|
|
429
|
-
return ensureLeadingSlash3(link);
|
|
430
|
-
};
|
|
431
|
-
var getPermalinkPattern = ({
|
|
432
|
-
app,
|
|
433
|
-
frontmatter
|
|
434
|
-
}) => {
|
|
435
|
-
if (frontmatter.permalinkPattern === null) {
|
|
436
|
-
return null;
|
|
437
|
-
}
|
|
438
|
-
if (isString3(frontmatter.permalinkPattern)) {
|
|
439
|
-
return frontmatter.permalinkPattern;
|
|
440
|
-
}
|
|
441
|
-
return app.options.permalinkPattern;
|
|
442
|
-
};
|
|
443
|
-
|
|
444
|
-
// src/page/resolvePageRouteMeta.ts
|
|
445
|
-
var resolvePageRouteMeta = ({
|
|
446
|
-
frontmatter
|
|
447
|
-
}) => frontmatter.routeMeta ?? {};
|
|
448
|
-
|
|
449
|
-
// src/page/resolvePageSlug.ts
|
|
450
|
-
import { path as path6 } from "@vuepress/utils";
|
|
451
|
-
var DATE_RE = /(\d{4}-\d{1,2}(-\d{1,2})?)-(.*)/;
|
|
452
|
-
var resolvePageSlug = ({
|
|
453
|
-
filePathRelative
|
|
454
|
-
}) => {
|
|
455
|
-
if (!filePathRelative) {
|
|
456
|
-
return "";
|
|
457
|
-
}
|
|
458
|
-
const filename = path6.parse(filePathRelative).name;
|
|
459
|
-
const match = filename.match(DATE_RE);
|
|
460
|
-
return match ? match[3] : filename;
|
|
461
|
-
};
|
|
462
|
-
|
|
463
|
-
// src/page/createPage.ts
|
|
464
|
-
var createPage = async (app, options) => {
|
|
465
|
-
await app.pluginApi.hooks.extendsPageOptions.process(options, app);
|
|
466
|
-
const { filePath, filePathRelative } = resolvePageFilePath({
|
|
467
|
-
app,
|
|
468
|
-
options
|
|
469
|
-
});
|
|
470
|
-
const content = await resolvePageFileContent({ filePath, options });
|
|
471
|
-
const {
|
|
472
|
-
contentRendered,
|
|
473
|
-
deps,
|
|
474
|
-
frontmatter,
|
|
475
|
-
headers,
|
|
476
|
-
links,
|
|
477
|
-
markdownEnv,
|
|
478
|
-
sfcBlocks,
|
|
479
|
-
title
|
|
480
|
-
} = renderPageContent({
|
|
481
|
-
app,
|
|
482
|
-
content,
|
|
483
|
-
filePath,
|
|
484
|
-
filePathRelative,
|
|
485
|
-
options
|
|
486
|
-
});
|
|
487
|
-
const routeMeta = resolvePageRouteMeta({ frontmatter });
|
|
488
|
-
const slug = resolvePageSlug({ filePathRelative });
|
|
489
|
-
const date = resolvePageDate({ frontmatter, filePathRelative });
|
|
490
|
-
const { pathInferred, pathLocale } = inferPagePath({ app, filePathRelative });
|
|
491
|
-
const lang = resolvePageLang({ app, frontmatter, pathLocale });
|
|
492
|
-
const permalink = resolvePagePermalink({
|
|
493
|
-
app,
|
|
494
|
-
frontmatter,
|
|
495
|
-
slug,
|
|
496
|
-
date,
|
|
497
|
-
pathInferred,
|
|
498
|
-
pathLocale
|
|
499
|
-
});
|
|
500
|
-
const path9 = resolvePagePath({ permalink, pathInferred, options });
|
|
501
|
-
const { htmlFilePath, htmlFilePathRelative } = resolvePageHtmlInfo({
|
|
502
|
-
app,
|
|
503
|
-
path: path9
|
|
504
|
-
});
|
|
505
|
-
const { componentFilePath, componentFilePathRelative } = await resolvePageComponentInfo({
|
|
506
|
-
app,
|
|
507
|
-
htmlFilePathRelative
|
|
508
|
-
});
|
|
509
|
-
const { chunkFilePath, chunkFilePathRelative, chunkName } = resolvePageChunkInfo({ app, htmlFilePathRelative });
|
|
510
|
-
const page = {
|
|
511
|
-
// page data
|
|
512
|
-
data: {
|
|
513
|
-
path: path9,
|
|
514
|
-
title,
|
|
515
|
-
lang,
|
|
516
|
-
frontmatter,
|
|
517
|
-
headers
|
|
518
|
-
},
|
|
519
|
-
// base fields
|
|
520
|
-
path: path9,
|
|
521
|
-
title,
|
|
522
|
-
lang,
|
|
523
|
-
frontmatter,
|
|
524
|
-
headers,
|
|
525
|
-
// extra fields
|
|
526
|
-
content,
|
|
527
|
-
contentRendered,
|
|
528
|
-
date,
|
|
529
|
-
deps,
|
|
530
|
-
links,
|
|
531
|
-
markdownEnv,
|
|
532
|
-
pathInferred,
|
|
533
|
-
pathLocale,
|
|
534
|
-
permalink,
|
|
535
|
-
routeMeta,
|
|
536
|
-
sfcBlocks,
|
|
537
|
-
slug,
|
|
538
|
-
// file info
|
|
539
|
-
filePath,
|
|
540
|
-
filePathRelative,
|
|
541
|
-
componentFilePath,
|
|
542
|
-
componentFilePathRelative,
|
|
543
|
-
chunkFilePath,
|
|
544
|
-
chunkFilePathRelative,
|
|
545
|
-
chunkName,
|
|
546
|
-
htmlFilePath,
|
|
547
|
-
htmlFilePathRelative
|
|
548
|
-
};
|
|
549
|
-
await app.pluginApi.hooks.extendsPage.process(page, app);
|
|
550
|
-
return page;
|
|
551
|
-
};
|
|
552
|
-
|
|
553
|
-
// src/app/resolveAppPages.ts
|
|
554
|
-
var log2 = debug2("vuepress:core/app");
|
|
555
|
-
var resolveAppPages = async (app) => {
|
|
556
|
-
log2("resolveAppPages start");
|
|
557
|
-
const pageFilePaths = await globby(app.options.pagePatterns, {
|
|
558
|
-
absolute: true,
|
|
559
|
-
cwd: app.dir.source()
|
|
560
|
-
});
|
|
561
|
-
const pages = await Promise.all(
|
|
562
|
-
pageFilePaths.map((filePath) => createPage(app, { filePath }))
|
|
563
|
-
);
|
|
564
|
-
const notFoundPage = pages.find((page) => page.path === "/404.html");
|
|
565
|
-
if (notFoundPage) {
|
|
566
|
-
notFoundPage.frontmatter.layout ??= "NotFound";
|
|
567
|
-
} else {
|
|
568
|
-
pages.push(
|
|
569
|
-
await createPage(app, {
|
|
570
|
-
path: "/404.html",
|
|
571
|
-
frontmatter: { layout: "NotFound" },
|
|
572
|
-
content: "404 Not Found"
|
|
573
|
-
})
|
|
574
|
-
);
|
|
575
|
-
}
|
|
576
|
-
log2("resolveAppPages finish");
|
|
577
|
-
return pages;
|
|
578
|
-
};
|
|
579
|
-
|
|
580
|
-
// src/app/appInit.ts
|
|
581
|
-
var log3 = debug3("vuepress:core/app");
|
|
582
|
-
var appInit = async (app) => {
|
|
583
|
-
log3("init start");
|
|
584
|
-
app.pluginApi.registerHooks();
|
|
585
|
-
app.markdown = await resolveAppMarkdown(app);
|
|
586
|
-
app.pages = await resolveAppPages(app);
|
|
587
|
-
await app.pluginApi.hooks.onInitialized.process(app);
|
|
588
|
-
log3("init finish");
|
|
589
|
-
};
|
|
590
|
-
|
|
591
|
-
// src/app/appPrepare.ts
|
|
592
|
-
import { debug as debug4 } from "@vuepress/utils";
|
|
593
|
-
var log4 = debug4("vuepress:core/app");
|
|
594
|
-
var appPrepare = async (app) => {
|
|
595
|
-
log4("prepare start");
|
|
596
|
-
for (const page of app.pages) {
|
|
597
|
-
await preparePageComponent(app, page);
|
|
598
|
-
}
|
|
599
|
-
for (const page of app.pages) {
|
|
600
|
-
await preparePageChunk(app, page);
|
|
601
|
-
}
|
|
602
|
-
await prepareRoutes(app);
|
|
603
|
-
await prepareSiteData(app);
|
|
604
|
-
await prepareClientConfigs(app);
|
|
605
|
-
await app.pluginApi.hooks.onPrepared.process(app);
|
|
606
|
-
log4("prepare finish");
|
|
607
|
-
};
|
|
608
|
-
|
|
609
|
-
// src/app/appUse.ts
|
|
610
|
-
import { colors, debug as debug5, warn } from "@vuepress/utils";
|
|
611
|
-
|
|
612
|
-
// src/app/resolvePluginObject.ts
|
|
613
|
-
import { isFunction } from "@vuepress/shared";
|
|
614
|
-
var resolvePluginObject = (app, plugin) => isFunction(plugin) ? plugin(app) : plugin;
|
|
615
|
-
|
|
616
|
-
// src/app/appUse.ts
|
|
617
|
-
var log5 = debug5("vuepress:core/app");
|
|
618
|
-
var appUse = (app, rawPlugin) => {
|
|
619
|
-
const pluginObject = resolvePluginObject(app, rawPlugin);
|
|
620
|
-
if (!pluginObject.name) {
|
|
621
|
-
warn(`an anonymous plugin or theme was detected and ignored`);
|
|
622
|
-
return app;
|
|
623
|
-
}
|
|
624
|
-
log5(`use plugin ${colors.magenta(pluginObject.name)}`);
|
|
625
|
-
if (pluginObject.multiple !== true) {
|
|
626
|
-
const duplicateIndex = app.pluginApi.plugins.findIndex(
|
|
627
|
-
({ name }) => name === pluginObject.name
|
|
628
|
-
);
|
|
629
|
-
if (duplicateIndex !== -1) {
|
|
630
|
-
app.pluginApi.plugins.splice(duplicateIndex, 1);
|
|
631
|
-
warn(
|
|
632
|
-
`plugin ${colors.magenta(
|
|
633
|
-
pluginObject.name
|
|
634
|
-
)} has been used multiple times, only the last one will take effect`
|
|
635
|
-
);
|
|
636
|
-
}
|
|
637
|
-
}
|
|
638
|
-
app.pluginApi.plugins.push(pluginObject);
|
|
639
|
-
return app;
|
|
640
|
-
};
|
|
641
|
-
|
|
642
|
-
// src/pluginApi/createHookQueue.ts
|
|
643
|
-
import { colors as colors2, debug as debug6, logger as logger3 } from "@vuepress/utils";
|
|
644
|
-
var log6 = debug6("vuepress:core/plugin-api");
|
|
645
|
-
var createHookQueue = (name) => {
|
|
646
|
-
const items = [];
|
|
647
|
-
const hookQueue = {
|
|
648
|
-
name,
|
|
649
|
-
items,
|
|
650
|
-
add: (item) => {
|
|
651
|
-
items.push(item);
|
|
652
|
-
},
|
|
653
|
-
process: async (...args) => {
|
|
654
|
-
const results = [];
|
|
655
|
-
for (const item of items) {
|
|
656
|
-
log6(
|
|
657
|
-
`process ${colors2.magenta(name)} from ${colors2.magenta(
|
|
658
|
-
item.pluginName
|
|
659
|
-
)}`
|
|
660
|
-
);
|
|
661
|
-
try {
|
|
662
|
-
const result = await item.hook(...args);
|
|
663
|
-
if (result !== void 0) {
|
|
664
|
-
results.push(result);
|
|
665
|
-
}
|
|
666
|
-
} catch (e) {
|
|
667
|
-
logger3.error(
|
|
668
|
-
`error in hook ${colors2.magenta(name)} from ${colors2.magenta(
|
|
669
|
-
item.pluginName
|
|
670
|
-
)}`
|
|
671
|
-
);
|
|
672
|
-
throw e;
|
|
673
|
-
}
|
|
674
|
-
}
|
|
675
|
-
return results;
|
|
676
|
-
}
|
|
677
|
-
};
|
|
678
|
-
return hookQueue;
|
|
679
|
-
};
|
|
680
|
-
|
|
681
|
-
// src/pluginApi/createPluginApiHooks.ts
|
|
682
|
-
var createPluginApiHooks = () => ({
|
|
683
|
-
// life cycle hooks
|
|
684
|
-
onInitialized: createHookQueue("onInitialized"),
|
|
685
|
-
onPrepared: createHookQueue("onPrepared"),
|
|
686
|
-
onWatched: createHookQueue("onWatched"),
|
|
687
|
-
onGenerated: createHookQueue("onGenerated"),
|
|
688
|
-
// extends hooks
|
|
689
|
-
extendsMarkdownOptions: createHookQueue("extendsMarkdownOptions"),
|
|
690
|
-
extendsMarkdown: createHookQueue("extendsMarkdown"),
|
|
691
|
-
extendsPageOptions: createHookQueue("extendsPageOptions"),
|
|
692
|
-
extendsPage: createHookQueue("extendsPage"),
|
|
693
|
-
extendsBundlerOptions: createHookQueue("extendsBundlerOptions"),
|
|
694
|
-
// client config file hooks
|
|
695
|
-
clientConfigFile: createHookQueue("clientConfigFile"),
|
|
696
|
-
// bundler hooks
|
|
697
|
-
alias: createHookQueue("alias"),
|
|
698
|
-
define: createHookQueue("define")
|
|
499
|
+
if (app.env.isDev) content += HMR_CODE;
|
|
500
|
+
await app.writeTemp("internal/siteData.js", content);
|
|
501
|
+
};
|
|
502
|
+
//#endregion
|
|
503
|
+
//#region src/app/prepare/prepareUserStyle.ts
|
|
504
|
+
/**
|
|
505
|
+
* Generate user style temp file
|
|
506
|
+
*
|
|
507
|
+
* @internal
|
|
508
|
+
*/
|
|
509
|
+
const prepareUserStyle = async (app, fileExists = null) => {
|
|
510
|
+
let content = "";
|
|
511
|
+
const { userStyle } = app.options;
|
|
512
|
+
if (userStyle) {
|
|
513
|
+
const userStylePath = app.dir.source(userStyle);
|
|
514
|
+
if (fileExists ?? await fs.pathExists(userStylePath)) content += `import ${JSON.stringify(userStylePath)}\n`;
|
|
515
|
+
}
|
|
516
|
+
await app.writeTemp("internal/userStyle.js", content);
|
|
517
|
+
};
|
|
518
|
+
//#endregion
|
|
519
|
+
//#region src/app/resolveAppMarkdown.ts
|
|
520
|
+
/**
|
|
521
|
+
* Resolve markdown-it instance for vuepress app
|
|
522
|
+
*
|
|
523
|
+
* @internal
|
|
524
|
+
*/
|
|
525
|
+
const resolveAppMarkdown = async (app) => {
|
|
526
|
+
await app.pluginApi.hooks.extendsMarkdownOptions.process(app.options.markdown, app);
|
|
527
|
+
const markdown = createMarkdown(app.options.markdown);
|
|
528
|
+
await app.pluginApi.hooks.extendsMarkdown.process(markdown, app);
|
|
529
|
+
return markdown;
|
|
530
|
+
};
|
|
531
|
+
//#endregion
|
|
532
|
+
//#region src/constants.ts
|
|
533
|
+
const DEFAULT_IGNORE_PATTERNS = [
|
|
534
|
+
"**/node_modules",
|
|
535
|
+
"**/.yarn",
|
|
536
|
+
"**/.git",
|
|
537
|
+
"**/.svn",
|
|
538
|
+
"**/.hg"
|
|
539
|
+
];
|
|
540
|
+
//#endregion
|
|
541
|
+
//#region src/app/resolveAppPages.ts
|
|
542
|
+
const log$4 = debug("vuepress:core/app");
|
|
543
|
+
/**
|
|
544
|
+
* Resolve pages for vuepress app
|
|
545
|
+
*
|
|
546
|
+
* @internal
|
|
547
|
+
*/
|
|
548
|
+
const resolveAppPages = async (app) => {
|
|
549
|
+
log$4("resolveAppPages start");
|
|
550
|
+
const pageFilePaths = await tinyglobby.glob(app.options.pagePatterns, {
|
|
551
|
+
absolute: true,
|
|
552
|
+
cwd: app.dir.source(),
|
|
553
|
+
ignore: DEFAULT_IGNORE_PATTERNS
|
|
554
|
+
});
|
|
555
|
+
let hasNotFoundPage = false;
|
|
556
|
+
const pagesMap = {};
|
|
557
|
+
const pages = await Promise.all(pageFilePaths.map(async (filePath) => {
|
|
558
|
+
const page = await createPage(app, { filePath });
|
|
559
|
+
if (page.filePath) pagesMap[page.filePath] = page;
|
|
560
|
+
if (page.path === "/404.html") {
|
|
561
|
+
page.frontmatter.layout ??= "NotFound";
|
|
562
|
+
hasNotFoundPage = true;
|
|
563
|
+
}
|
|
564
|
+
return page;
|
|
565
|
+
}));
|
|
566
|
+
if (!hasNotFoundPage) pages.push(await createPage(app, {
|
|
567
|
+
path: "/404.html",
|
|
568
|
+
frontmatter: { layout: "NotFound" },
|
|
569
|
+
content: "404 Not Found"
|
|
570
|
+
}));
|
|
571
|
+
log$4("resolveAppPages finish");
|
|
572
|
+
return {
|
|
573
|
+
pages,
|
|
574
|
+
pagesMap
|
|
575
|
+
};
|
|
576
|
+
};
|
|
577
|
+
//#endregion
|
|
578
|
+
//#region src/app/appInit.ts
|
|
579
|
+
const log$3 = debug("vuepress:core/app");
|
|
580
|
+
/**
|
|
581
|
+
* Initialize a vuepress app
|
|
582
|
+
*
|
|
583
|
+
* Plugins should be used before initialization.
|
|
584
|
+
*
|
|
585
|
+
* @internal
|
|
586
|
+
*/
|
|
587
|
+
const appInit = async (app) => {
|
|
588
|
+
log$3("init start");
|
|
589
|
+
app.pluginApi.registerHooks();
|
|
590
|
+
app.markdown = await resolveAppMarkdown(app);
|
|
591
|
+
const { pages, pagesMap } = await resolveAppPages(app);
|
|
592
|
+
app.pages = pages;
|
|
593
|
+
app.pagesMap = pagesMap;
|
|
594
|
+
await app.pluginApi.hooks.onInitialized.process(app);
|
|
595
|
+
log$3("init finish");
|
|
596
|
+
};
|
|
597
|
+
//#endregion
|
|
598
|
+
//#region src/app/appPrepare.ts
|
|
599
|
+
const log$2 = debug("vuepress:core/app");
|
|
600
|
+
/**
|
|
601
|
+
* Prepare files for development or build
|
|
602
|
+
*
|
|
603
|
+
* - page chunks
|
|
604
|
+
* - routes
|
|
605
|
+
* - site data
|
|
606
|
+
* - other files that generated by plugins
|
|
607
|
+
*
|
|
608
|
+
* @internal
|
|
609
|
+
*/
|
|
610
|
+
const appPrepare = async (app) => {
|
|
611
|
+
log$2("prepare start");
|
|
612
|
+
await Promise.all([
|
|
613
|
+
...app.pages.map(async (page) => preparePageChunk(app, page)),
|
|
614
|
+
prepareRoutes(app),
|
|
615
|
+
prepareSiteData(app),
|
|
616
|
+
prepareClientConfigs(app),
|
|
617
|
+
prepareUserStyle(app)
|
|
618
|
+
]);
|
|
619
|
+
await app.pluginApi.hooks.onPrepared.process(app);
|
|
620
|
+
log$2("prepare finish");
|
|
621
|
+
};
|
|
622
|
+
//#endregion
|
|
623
|
+
//#region src/app/resolvePluginObject.ts
|
|
624
|
+
/**
|
|
625
|
+
* Resolve a plugin object according to name / path / module and config
|
|
626
|
+
*
|
|
627
|
+
* @internal
|
|
628
|
+
*/
|
|
629
|
+
const resolvePluginObject = (app, plugin) => isFunction(plugin) ? plugin(app) : plugin;
|
|
630
|
+
//#endregion
|
|
631
|
+
//#region src/app/appUse.ts
|
|
632
|
+
const log$1 = debug("vuepress:core/app");
|
|
633
|
+
/**
|
|
634
|
+
* Use a plugin in vuepress app.
|
|
635
|
+
*
|
|
636
|
+
* Should be called before initialization.
|
|
637
|
+
*
|
|
638
|
+
* @internal
|
|
639
|
+
*/
|
|
640
|
+
const appUse = (app, rawPlugin) => {
|
|
641
|
+
const pluginObject = resolvePluginObject(app, rawPlugin);
|
|
642
|
+
if (!pluginObject.name) {
|
|
643
|
+
warn(`an anonymous plugin or theme was detected and ignored`);
|
|
644
|
+
return app;
|
|
645
|
+
}
|
|
646
|
+
log$1(`use plugin ${colors.magenta(pluginObject.name)}`);
|
|
647
|
+
if (pluginObject.multiple !== true) {
|
|
648
|
+
const duplicateIndex = app.pluginApi.plugins.findIndex(({ name }) => name === pluginObject.name);
|
|
649
|
+
if (duplicateIndex !== -1) {
|
|
650
|
+
app.pluginApi.plugins.splice(duplicateIndex, 1);
|
|
651
|
+
warn(`plugin ${colors.magenta(pluginObject.name)} has been used multiple times, only the last one will take effect`);
|
|
652
|
+
}
|
|
653
|
+
}
|
|
654
|
+
app.pluginApi.plugins.push(pluginObject);
|
|
655
|
+
return app;
|
|
656
|
+
};
|
|
657
|
+
//#endregion
|
|
658
|
+
//#region src/pluginApi/createHookQueue.ts
|
|
659
|
+
const log = debug("vuepress:core/plugin-api");
|
|
660
|
+
/**
|
|
661
|
+
* Create hook queue for plugin system
|
|
662
|
+
*
|
|
663
|
+
* @internal
|
|
664
|
+
*/
|
|
665
|
+
const createHookQueue = (name) => {
|
|
666
|
+
const items = [];
|
|
667
|
+
return {
|
|
668
|
+
name,
|
|
669
|
+
items,
|
|
670
|
+
add: (item) => {
|
|
671
|
+
items.push(item);
|
|
672
|
+
},
|
|
673
|
+
process: async (...args) => {
|
|
674
|
+
const results = [];
|
|
675
|
+
for (const item of items) {
|
|
676
|
+
log(`process ${colors.magenta(name)} from ${colors.magenta(item.pluginName)}`);
|
|
677
|
+
try {
|
|
678
|
+
const result = await item.hook(...args);
|
|
679
|
+
if (result !== void 0) results.push(result);
|
|
680
|
+
} catch (e) {
|
|
681
|
+
logger.error(`error in hook ${colors.magenta(name)} from ${colors.magenta(item.pluginName)}`);
|
|
682
|
+
throw e;
|
|
683
|
+
}
|
|
684
|
+
}
|
|
685
|
+
return results;
|
|
686
|
+
}
|
|
687
|
+
};
|
|
688
|
+
};
|
|
689
|
+
//#endregion
|
|
690
|
+
//#region src/pluginApi/createPluginApiHooks.ts
|
|
691
|
+
/**
|
|
692
|
+
* Create hooks for plugin api
|
|
693
|
+
*
|
|
694
|
+
* @internal
|
|
695
|
+
*/
|
|
696
|
+
const createPluginApiHooks = () => ({
|
|
697
|
+
onInitialized: createHookQueue("onInitialized"),
|
|
698
|
+
onPrepared: createHookQueue("onPrepared"),
|
|
699
|
+
onWatched: createHookQueue("onWatched"),
|
|
700
|
+
onPageUpdated: createHookQueue("onPageUpdated"),
|
|
701
|
+
onGenerated: createHookQueue("onGenerated"),
|
|
702
|
+
extendsMarkdownOptions: createHookQueue("extendsMarkdownOptions"),
|
|
703
|
+
extendsMarkdown: createHookQueue("extendsMarkdown"),
|
|
704
|
+
extendsPageOptions: createHookQueue("extendsPageOptions"),
|
|
705
|
+
extendsPage: createHookQueue("extendsPage"),
|
|
706
|
+
extendsBundlerOptions: createHookQueue("extendsBundlerOptions"),
|
|
707
|
+
clientConfigFile: createHookQueue("clientConfigFile"),
|
|
708
|
+
alias: createHookQueue("alias"),
|
|
709
|
+
define: createHookQueue("define")
|
|
699
710
|
});
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
};
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
};
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
};
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
var resolveAppOptions = ({
|
|
810
|
-
// site config
|
|
811
|
-
base = "/",
|
|
812
|
-
lang = "en-US",
|
|
813
|
-
title = "",
|
|
814
|
-
description = "",
|
|
815
|
-
head = [],
|
|
816
|
-
locales = {},
|
|
817
|
-
// directory config
|
|
818
|
-
source,
|
|
819
|
-
dest = path8.resolve(source, ".vuepress/dist"),
|
|
820
|
-
temp = path8.resolve(source, ".vuepress/.temp"),
|
|
821
|
-
cache = path8.resolve(source, ".vuepress/.cache"),
|
|
822
|
-
public: publicDir = path8.resolve(source, ".vuepress/public"),
|
|
823
|
-
// dev config
|
|
824
|
-
host = "0.0.0.0",
|
|
825
|
-
port = 8080,
|
|
826
|
-
open = false,
|
|
827
|
-
templateDev = path8.normalize(
|
|
828
|
-
require3.resolve("@vuepress/client/templates/dev.html")
|
|
829
|
-
),
|
|
830
|
-
// build config
|
|
831
|
-
shouldPreload = true,
|
|
832
|
-
shouldPrefetch = true,
|
|
833
|
-
templateBuild = path8.normalize(
|
|
834
|
-
require3.resolve("@vuepress/client/templates/build.html")
|
|
835
|
-
),
|
|
836
|
-
// common config
|
|
837
|
-
bundler,
|
|
838
|
-
debug: debug7 = false,
|
|
839
|
-
markdown = {},
|
|
840
|
-
pagePatterns = ["**/*.md", "!.vuepress", "!node_modules"],
|
|
841
|
-
permalinkPattern = null,
|
|
842
|
-
plugins = [],
|
|
843
|
-
theme
|
|
844
|
-
}) => ({
|
|
845
|
-
base,
|
|
846
|
-
lang,
|
|
847
|
-
title,
|
|
848
|
-
description,
|
|
849
|
-
head,
|
|
850
|
-
locales,
|
|
851
|
-
source,
|
|
852
|
-
dest,
|
|
853
|
-
temp,
|
|
854
|
-
cache,
|
|
855
|
-
public: publicDir,
|
|
856
|
-
host,
|
|
857
|
-
port,
|
|
858
|
-
open,
|
|
859
|
-
templateDev,
|
|
860
|
-
shouldPreload,
|
|
861
|
-
shouldPrefetch,
|
|
862
|
-
templateBuild,
|
|
863
|
-
templateBuildRenderer: templateRenderer,
|
|
864
|
-
bundler,
|
|
865
|
-
debug: debug7,
|
|
866
|
-
markdown,
|
|
867
|
-
pagePatterns,
|
|
868
|
-
permalinkPattern,
|
|
869
|
-
plugins,
|
|
870
|
-
theme
|
|
711
|
+
//#endregion
|
|
712
|
+
//#region src/pluginApi/normalizeAliasDefineHook.ts
|
|
713
|
+
/**
|
|
714
|
+
* Normalize alias and define hook
|
|
715
|
+
*
|
|
716
|
+
* @internal
|
|
717
|
+
*/
|
|
718
|
+
const normalizeAliasDefineHook = (hook) => async (app, isServer) => isFunction(hook) ? hook(app, isServer) : hook;
|
|
719
|
+
//#endregion
|
|
720
|
+
//#region src/pluginApi/normalizeClientConfigFileHook.ts
|
|
721
|
+
/**
|
|
722
|
+
* Normalize hook for client config file
|
|
723
|
+
*
|
|
724
|
+
* @internal
|
|
725
|
+
*/
|
|
726
|
+
const normalizeClientConfigFileHook = (hook) => async (app) => {
|
|
727
|
+
const clientConfigFileResult = isFunction(hook) ? await hook(app) : hook;
|
|
728
|
+
if (!await fs.pathExists(clientConfigFileResult)) throw logger.createError(`client config file does not exist: ${clientConfigFileResult}`);
|
|
729
|
+
return clientConfigFileResult;
|
|
730
|
+
};
|
|
731
|
+
//#endregion
|
|
732
|
+
//#region src/pluginApi/createPluginApiRegisterHooks.ts
|
|
733
|
+
/**
|
|
734
|
+
* Create registerHooks method for plugin api
|
|
735
|
+
*
|
|
736
|
+
* @internal
|
|
737
|
+
*/
|
|
738
|
+
const createPluginApiRegisterHooks = (plugins, hooks) => () => {
|
|
739
|
+
plugins.forEach(({ name: pluginName, multiple, alias, define, clientConfigFile, ...commonHooks }) => {
|
|
740
|
+
/**
|
|
741
|
+
* hooks that need to be normalized
|
|
742
|
+
*/
|
|
743
|
+
if (alias) hooks.alias.add({
|
|
744
|
+
pluginName,
|
|
745
|
+
hook: normalizeAliasDefineHook(alias)
|
|
746
|
+
});
|
|
747
|
+
if (define) hooks.define.add({
|
|
748
|
+
pluginName,
|
|
749
|
+
hook: normalizeAliasDefineHook(define)
|
|
750
|
+
});
|
|
751
|
+
if (clientConfigFile) hooks.clientConfigFile.add({
|
|
752
|
+
pluginName,
|
|
753
|
+
hook: normalizeClientConfigFileHook(clientConfigFile)
|
|
754
|
+
});
|
|
755
|
+
/**
|
|
756
|
+
* common hooks
|
|
757
|
+
*/
|
|
758
|
+
Object.keys(commonHooks).forEach((key) => {
|
|
759
|
+
if (hooks[key] && commonHooks[key]) hooks[key].add({
|
|
760
|
+
pluginName,
|
|
761
|
+
hook: commonHooks[key]
|
|
762
|
+
});
|
|
763
|
+
});
|
|
764
|
+
});
|
|
765
|
+
};
|
|
766
|
+
//#endregion
|
|
767
|
+
//#region src/pluginApi/createPluginApi.ts
|
|
768
|
+
/**
|
|
769
|
+
* Create vuepress plugin api
|
|
770
|
+
*
|
|
771
|
+
* @internal
|
|
772
|
+
*/
|
|
773
|
+
const createPluginApi = () => {
|
|
774
|
+
const plugins = [];
|
|
775
|
+
const hooks = createPluginApiHooks();
|
|
776
|
+
return {
|
|
777
|
+
plugins,
|
|
778
|
+
hooks,
|
|
779
|
+
registerHooks: createPluginApiRegisterHooks(plugins, hooks)
|
|
780
|
+
};
|
|
781
|
+
};
|
|
782
|
+
//#endregion
|
|
783
|
+
//#region src/app/resolveAppDir.ts
|
|
784
|
+
const require$2 = createRequire(import.meta.url);
|
|
785
|
+
/**
|
|
786
|
+
* Create directory util function
|
|
787
|
+
*
|
|
788
|
+
* @internal
|
|
789
|
+
*/
|
|
790
|
+
const createAppDirFunction = (baseDir) => (...args) => path.resolve(baseDir, ...args);
|
|
791
|
+
/**
|
|
792
|
+
* Resolve directory utils for vuepress app
|
|
793
|
+
*/
|
|
794
|
+
const resolveAppDir = (options) => {
|
|
795
|
+
const cache = createAppDirFunction(options.cache);
|
|
796
|
+
const temp = createAppDirFunction(options.temp);
|
|
797
|
+
const source = createAppDirFunction(options.source);
|
|
798
|
+
const dest = createAppDirFunction(options.dest);
|
|
799
|
+
const publicDir = createAppDirFunction(options.public);
|
|
800
|
+
return {
|
|
801
|
+
cache,
|
|
802
|
+
temp,
|
|
803
|
+
source,
|
|
804
|
+
dest,
|
|
805
|
+
client: createAppDirFunction(path.resolve(require$2.resolve("@vuepress/client/package.json"), "..")),
|
|
806
|
+
public: publicDir
|
|
807
|
+
};
|
|
808
|
+
};
|
|
809
|
+
//#endregion
|
|
810
|
+
//#region src/app/resolveAppEnv.ts
|
|
811
|
+
/**
|
|
812
|
+
* Resolve environment flags for vuepress app
|
|
813
|
+
*
|
|
814
|
+
* @internal
|
|
815
|
+
*/
|
|
816
|
+
const resolveAppEnv = (options) => ({
|
|
817
|
+
isBuild: false,
|
|
818
|
+
isDev: false,
|
|
819
|
+
isDebug: options.debug
|
|
871
820
|
});
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
|
|
821
|
+
//#endregion
|
|
822
|
+
//#region src/app/resolveAppOptions.ts
|
|
823
|
+
const require$1 = createRequire(import.meta.url);
|
|
824
|
+
/**
|
|
825
|
+
* Create app options with default values
|
|
826
|
+
*
|
|
827
|
+
* @internal
|
|
828
|
+
*/
|
|
829
|
+
const resolveAppOptions = ({ base = "/", lang = "en-US", title = "", description = "", head = [], locales = {}, source, dest = path.resolve(source, ".vuepress/dist"), temp = path.resolve(source, ".vuepress/.temp"), cache = path.resolve(source, ".vuepress/.cache"), public: publicDir = path.resolve(source, ".vuepress/public"), host = "0.0.0.0", port = 8080, open = false, templateDev = path.normalize(require$1.resolve("@vuepress/client/templates/dev.html")), shouldPreload = true, shouldPrefetch = true, templateBuild = path.normalize(require$1.resolve("@vuepress/client/templates/build.html")), templateBuildRenderer = templateRenderer, bundler, debug = false, markdown = {}, pagePatterns = ["**/*.md", "!.vuepress"], permalinkPattern = null, userStyle = null, plugins = [], theme }) => {
|
|
830
|
+
locales["/"] ??= {
|
|
831
|
+
lang,
|
|
832
|
+
title,
|
|
833
|
+
description
|
|
834
|
+
};
|
|
835
|
+
return {
|
|
836
|
+
base,
|
|
837
|
+
lang,
|
|
838
|
+
title,
|
|
839
|
+
description,
|
|
840
|
+
head,
|
|
841
|
+
locales,
|
|
842
|
+
source,
|
|
843
|
+
dest,
|
|
844
|
+
temp,
|
|
845
|
+
cache,
|
|
846
|
+
public: publicDir,
|
|
847
|
+
host,
|
|
848
|
+
port,
|
|
849
|
+
open,
|
|
850
|
+
templateDev,
|
|
851
|
+
shouldPreload,
|
|
852
|
+
shouldPrefetch,
|
|
853
|
+
templateBuild,
|
|
854
|
+
templateBuildRenderer,
|
|
855
|
+
bundler,
|
|
856
|
+
debug,
|
|
857
|
+
markdown,
|
|
858
|
+
pagePatterns,
|
|
859
|
+
permalinkPattern,
|
|
860
|
+
userStyle,
|
|
861
|
+
plugins,
|
|
862
|
+
theme
|
|
863
|
+
};
|
|
864
|
+
};
|
|
865
|
+
//#endregion
|
|
866
|
+
//#region src/app/resolveAppSiteData.ts
|
|
867
|
+
/**
|
|
868
|
+
* Resolve site data for vuepress app
|
|
869
|
+
*
|
|
870
|
+
* Site data will also be used in client
|
|
871
|
+
*
|
|
872
|
+
* @internal
|
|
873
|
+
*/
|
|
874
|
+
const resolveAppSiteData = (options) => ({
|
|
875
|
+
base: options.base,
|
|
876
|
+
lang: options.lang,
|
|
877
|
+
title: options.title,
|
|
878
|
+
description: options.description,
|
|
879
|
+
head: options.head,
|
|
880
|
+
locales: options.locales
|
|
881
881
|
});
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
};
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
|
|
915
|
-
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
};
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
|
|
938
|
-
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
|
|
1017
|
-
|
|
882
|
+
//#endregion
|
|
883
|
+
//#region src/app/resolveAppVersion.ts
|
|
884
|
+
const require = createRequire(import.meta.url);
|
|
885
|
+
/**
|
|
886
|
+
* Resolve version of vuepress app
|
|
887
|
+
*
|
|
888
|
+
* @internal
|
|
889
|
+
*/
|
|
890
|
+
const resolveAppVersion = () => {
|
|
891
|
+
return fs.readJsonSync(require.resolve("@vuepress/core/package.json")).version;
|
|
892
|
+
};
|
|
893
|
+
//#endregion
|
|
894
|
+
//#region src/app/resolveAppWriteTemp.ts
|
|
895
|
+
/**
|
|
896
|
+
* Resolve write temp file util for vuepress app
|
|
897
|
+
*
|
|
898
|
+
* @internal
|
|
899
|
+
*/
|
|
900
|
+
const resolveAppWriteTemp = (dir) => {
|
|
901
|
+
const cache = /* @__PURE__ */ new Map();
|
|
902
|
+
const writeTemp = (async (file, content) => {
|
|
903
|
+
const filePath = dir.temp(file);
|
|
904
|
+
const contentHash = hash(content);
|
|
905
|
+
let item = cache.get(filePath);
|
|
906
|
+
if (!item) cache.set(filePath, item = {});
|
|
907
|
+
if (item.hash === contentHash) return filePath;
|
|
908
|
+
item.hash = contentHash;
|
|
909
|
+
if (!item.current) item.current = (async () => {
|
|
910
|
+
await fs.outputFile(filePath, content);
|
|
911
|
+
item.current = item.next?.();
|
|
912
|
+
return item.current;
|
|
913
|
+
})();
|
|
914
|
+
else item.next = async () => {
|
|
915
|
+
await fs.outputFile(filePath, content);
|
|
916
|
+
item.next = void 0;
|
|
917
|
+
item.current = void 0;
|
|
918
|
+
};
|
|
919
|
+
await item.current;
|
|
920
|
+
return filePath;
|
|
921
|
+
});
|
|
922
|
+
writeTemp.cleanup = () => {
|
|
923
|
+
cache.clear();
|
|
924
|
+
};
|
|
925
|
+
return writeTemp;
|
|
926
|
+
};
|
|
927
|
+
//#endregion
|
|
928
|
+
//#region src/app/createBaseApp.ts
|
|
929
|
+
/**
|
|
930
|
+
* Create base vuepress app.
|
|
931
|
+
*
|
|
932
|
+
* Notice that the base app could not be used for dev nor build.
|
|
933
|
+
*
|
|
934
|
+
* It would be used for creating dev app or build app internally.
|
|
935
|
+
*
|
|
936
|
+
* @internal
|
|
937
|
+
*/
|
|
938
|
+
const createBaseApp = (config) => {
|
|
939
|
+
const options = resolveAppOptions(config);
|
|
940
|
+
const dir = resolveAppDir(options);
|
|
941
|
+
const env = resolveAppEnv(options);
|
|
942
|
+
const pluginApi = createPluginApi();
|
|
943
|
+
const app = {
|
|
944
|
+
options,
|
|
945
|
+
siteData: resolveAppSiteData(options),
|
|
946
|
+
version: resolveAppVersion(),
|
|
947
|
+
dir,
|
|
948
|
+
env,
|
|
949
|
+
pluginApi,
|
|
950
|
+
writeTemp: resolveAppWriteTemp(dir),
|
|
951
|
+
use: (plugin) => appUse(app, plugin),
|
|
952
|
+
init: async () => appInit(app),
|
|
953
|
+
prepare: async () => appPrepare(app)
|
|
954
|
+
};
|
|
955
|
+
return app;
|
|
956
|
+
};
|
|
957
|
+
//#endregion
|
|
958
|
+
//#region src/app/resolveThemeInfo.ts
|
|
959
|
+
/**
|
|
960
|
+
* Resolve theme info and its parent theme info
|
|
961
|
+
*
|
|
962
|
+
* @internal
|
|
963
|
+
*/
|
|
964
|
+
const resolveThemeInfo = (app, theme) => {
|
|
965
|
+
const themeObject = resolvePluginObject(app, theme);
|
|
966
|
+
const themeInfo = {
|
|
967
|
+
plugins: [...themeObject.plugins ?? [], themeObject],
|
|
968
|
+
templateBuild: themeObject.templateBuild,
|
|
969
|
+
templateBuildRenderer: themeObject.templateBuildRenderer,
|
|
970
|
+
templateDev: themeObject.templateDev,
|
|
971
|
+
userStyle: themeObject.userStyle
|
|
972
|
+
};
|
|
973
|
+
if (!themeObject.extends) return themeInfo;
|
|
974
|
+
const parentThemeInfo = resolveThemeInfo(app, themeObject.extends);
|
|
975
|
+
return {
|
|
976
|
+
plugins: [...parentThemeInfo.plugins, ...themeInfo.plugins],
|
|
977
|
+
templateBuild: themeObject.templateBuild ?? parentThemeInfo.templateBuild,
|
|
978
|
+
templateBuildRenderer: themeObject.templateBuildRenderer ?? parentThemeInfo.templateBuildRenderer,
|
|
979
|
+
templateDev: themeObject.templateDev ?? parentThemeInfo.templateDev,
|
|
980
|
+
userStyle: themeObject.userStyle ?? parentThemeInfo.userStyle
|
|
981
|
+
};
|
|
982
|
+
};
|
|
983
|
+
//#endregion
|
|
984
|
+
//#region src/app/setupAppThemeAndPlugins.ts
|
|
985
|
+
/**
|
|
986
|
+
* Setup theme and plugins for vuepress app
|
|
987
|
+
*
|
|
988
|
+
* @internal
|
|
989
|
+
*/
|
|
990
|
+
const setupAppThemeAndPlugins = (app, config) => {
|
|
991
|
+
const themeInfo = resolveThemeInfo(app, app.options.theme);
|
|
992
|
+
app.options.templateDev = config.templateDev ?? themeInfo.templateDev ?? app.options.templateDev;
|
|
993
|
+
app.options.templateBuild = config.templateBuild ?? themeInfo.templateBuild ?? app.options.templateBuild;
|
|
994
|
+
app.options.templateBuildRenderer = config.templateBuildRenderer ?? themeInfo.templateBuildRenderer ?? app.options.templateBuildRenderer;
|
|
995
|
+
app.options.userStyle = config.userStyle ?? themeInfo.userStyle ?? app.options.userStyle;
|
|
996
|
+
[...themeInfo.plugins, ...app.options.plugins].flat().forEach((plugin) => app.use(plugin));
|
|
997
|
+
};
|
|
998
|
+
//#endregion
|
|
999
|
+
//#region src/app/createBuildApp.ts
|
|
1000
|
+
/**
|
|
1001
|
+
* Create vuepress build app.
|
|
1002
|
+
*/
|
|
1003
|
+
const createBuildApp = (config) => {
|
|
1004
|
+
const app = createBaseApp(config);
|
|
1005
|
+
app.env.isBuild = true;
|
|
1006
|
+
app.build = async () => app.options.bundler.build(app);
|
|
1007
|
+
setupAppThemeAndPlugins(app, config);
|
|
1008
|
+
return app;
|
|
1009
|
+
};
|
|
1010
|
+
//#endregion
|
|
1011
|
+
//#region src/app/createDevApp.ts
|
|
1012
|
+
/**
|
|
1013
|
+
* Create vuepress dev app.
|
|
1014
|
+
*/
|
|
1015
|
+
const createDevApp = (config) => {
|
|
1016
|
+
const app = createBaseApp(config);
|
|
1017
|
+
app.env.isDev = true;
|
|
1018
|
+
app.dev = async () => app.options.bundler.dev(app);
|
|
1019
|
+
setupAppThemeAndPlugins(app, config);
|
|
1020
|
+
return app;
|
|
1021
|
+
};
|
|
1022
|
+
//#endregion
|
|
1023
|
+
export { DEFAULT_IGNORE_PATTERNS, appInit, appPrepare, appUse, createAppDirFunction, createBaseApp, createBuildApp, createDevApp, createHookQueue, createPage, createPluginApi, createPluginApiHooks, createPluginApiRegisterHooks, inferPagePath, normalizeAliasDefineHook, normalizeClientConfigFileHook, parsePageContent, prepareClientConfigs, preparePageChunk, prepareRoutes, prepareSiteData, prepareUserStyle, renderPageToVue, resolveAppDir, resolveAppEnv, resolveAppOptions, resolveAppPages, resolveAppSiteData, resolveAppVersion, resolveAppWriteTemp, resolvePageChunkInfo, resolvePageContent, resolvePageDate, resolvePageFilePath, resolvePageHtmlInfo, resolvePageLang, resolvePagePath, resolvePagePermalink, resolvePageRouteMeta, resolvePageSlug, resolvePluginObject, resolveThemeInfo };
|