@zzclub/pipeline 0.10.0 → 0.10.2

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.
Files changed (123) hide show
  1. package/README.md +113 -8
  2. package/package.json +4 -4
  3. package/src/adapter-types.ts +21 -0
  4. package/src/adapters/builtin-markdown-renderer.ts +7 -0
  5. package/src/cli.ts +5 -1
  6. package/src/commands/ingest-handoff.ts +1 -21
  7. package/src/commands/prepare-finalize.ts +2 -1
  8. package/src/commands/prepare.ts +30 -19
  9. package/src/commands/publish.ts +2 -3
  10. package/src/commands/reconcile.ts +3 -5
  11. package/src/commands/render.ts +2 -1
  12. package/src/commands/republish.ts +2 -3
  13. package/src/commands/reset.ts +9 -1
  14. package/src/commands/review.ts +3 -2
  15. package/src/commands/sync-blog.ts +2 -1
  16. package/src/commands/wechat-export.test.ts +41 -0
  17. package/src/commands/wechat-export.ts +156 -20
  18. package/src/commands/wechat-preview.ts +160 -0
  19. package/src/config.ts +12 -0
  20. package/src/imgx/runtime.ts +31 -3
  21. package/src/logger.test.ts +56 -0
  22. package/src/logger.ts +178 -0
  23. package/src/plugins.ts +2 -0
  24. package/src/providers/blog.ts +1 -2
  25. package/src/providers/index.ts +35 -3
  26. package/src/publish-targets.ts +4 -5
  27. package/src/routes.ts +9 -1
  28. package/src/schema/config.ts +2 -0
  29. package/src/state.ts +24 -0
  30. package/src/task-manager.test.ts +57 -0
  31. package/src/task-manager.ts +23 -5
  32. package/src/wechat-preview/assets/browser-dist/.vite/manifest.json +1 -302
  33. package/src/wechat-preview/assets/browser-dist/editor-export.js +500 -958
  34. package/src/wechat-preview/browser/assets.d.ts +9 -0
  35. package/src/wechat-preview/browser/editor-export.css +5 -326
  36. package/src/wechat-preview/browser/editor-export.ts +30 -65
  37. package/src/wechat-preview/bundle-stale.test.ts +52 -0
  38. package/src/wechat-preview/fixtures/all-nodes.md +68 -0
  39. package/src/wechat-preview/index.test.ts +17 -0
  40. package/src/wechat-preview/index.ts +424 -180
  41. package/src/wechat-preview/server/client.ts +164 -0
  42. package/src/wechat-preview/server/http.ts +229 -0
  43. package/src/wechat-preview/server/index.ts +33 -0
  44. package/src/wechat-preview/server/local-file.test.ts +52 -0
  45. package/src/wechat-preview/server/local-file.ts +116 -0
  46. package/src/wechat-preview/server/paths.ts +80 -0
  47. package/src/wechat-preview/server/registry.test.ts +60 -0
  48. package/src/wechat-preview/server/registry.ts +118 -0
  49. package/src/wechat-preview/server/singleton.ts +118 -0
  50. package/src/wechat-preview/server/types.ts +61 -0
  51. package/src/wechat-preview/server/ui.ts +324 -0
  52. package/src/wechat-preview/themes.ts +58 -45
  53. package/src/wechat-preview/wechat-export.integration.test.ts +94 -0
  54. package/src/wechat-preview/wechat-renderer.links.test.ts +44 -0
  55. package/src/wechat-preview/wechat-renderer.test.ts +50 -0
  56. package/src/wechat-preview/wechat-renderer.ts +698 -0
  57. package/src/wechat-preview.test.ts +25 -41
  58. package/src/workflow-materials.test.ts +52 -1
  59. package/src/workflow-materials.ts +12 -0
  60. package/src/workflow.test.ts +105 -5
  61. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
  62. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
  63. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
  64. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
  65. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
  66. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
  67. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
  68. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
  69. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
  70. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
  71. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
  72. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
  73. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
  74. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
  75. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
  76. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
  77. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
  78. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
  79. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
  80. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
  81. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
  82. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
  83. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
  84. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
  85. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
  86. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
  87. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
  88. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
  89. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
  90. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
  91. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
  92. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
  93. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
  94. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
  95. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
  96. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
  97. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
  98. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
  99. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
  100. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
  101. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
  102. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
  103. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
  104. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
  105. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
  106. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
  107. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
  108. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
  109. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
  110. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
  111. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
  112. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
  113. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
  114. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
  115. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
  116. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
  117. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
  118. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
  119. package/src/wechat-preview/assets/browser-dist/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
  120. package/src/wechat-preview/assets/browser-dist/assets/style-vhHYSP8T.css +0 -1
  121. package/src/wechat-preview/assets/fonts/SweiCurveLegCJKsc-Regular.woff +0 -0
  122. package/src/wechat-preview/wechat-formatter.test.ts +0 -287
  123. package/src/wechat-preview/wechat-formatter.ts +0 -1531
@@ -0,0 +1,698 @@
1
+ import juice from "juice/client";
2
+ import type { WechatExportTheme } from "./themes";
3
+
4
+ export type WechatElementKind =
5
+ | "image"
6
+ | "code-block"
7
+ | "inline-code"
8
+ | "heading"
9
+ | "paragraph"
10
+ | "emphasis"
11
+ | "blockquote"
12
+ | "link"
13
+ | "list"
14
+ | "table"
15
+ | "divider"
16
+ | "hard-break"
17
+ | "article";
18
+
19
+ export interface WechatLinkReference {
20
+ index: number;
21
+ text: string;
22
+ url: string;
23
+ }
24
+
25
+ export interface WechatRenderContext {
26
+ document: Document;
27
+ root: HTMLElement;
28
+ theme: WechatExportTheme;
29
+ references: WechatLinkReference[];
30
+ }
31
+
32
+ export interface WechatElementRenderer {
33
+ kind: WechatElementKind;
34
+ selector: string;
35
+ /** Optional selector used after CSS has been inlined. Defaults to selector. */
36
+ finalizeSelector?: string;
37
+ prepare?: (element: HTMLElement, context: WechatRenderContext) => void;
38
+ finalize?: (element: HTMLElement, context: WechatRenderContext) => void;
39
+ }
40
+
41
+ export type WechatRendererOverrides = Partial<Record<WechatElementKind, WechatElementRenderer>>;
42
+
43
+ export interface RenderWechatHtmlInput {
44
+ semanticHtml: string;
45
+ baseCss: string;
46
+ customCss?: string;
47
+ editorVars?: Record<string, string>;
48
+ theme: WechatExportTheme;
49
+ renderers?: WechatRendererOverrides;
50
+ }
51
+
52
+ const ALLOWED_TAGS = new Set([
53
+ "section",
54
+ "p",
55
+ "blockquote",
56
+ "ul",
57
+ "ol",
58
+ "li",
59
+ "pre",
60
+ "code",
61
+ "span",
62
+ "strong",
63
+ "em",
64
+ "b",
65
+ "i",
66
+ "u",
67
+ "s",
68
+ "del",
69
+ "a",
70
+ "img",
71
+ "br",
72
+ "hr",
73
+ "table",
74
+ "thead",
75
+ "tbody",
76
+ "tr",
77
+ "th",
78
+ "td",
79
+ ]);
80
+
81
+ const DROP_WITH_CONTENT = new Set([
82
+ "script",
83
+ "style",
84
+ "iframe",
85
+ "object",
86
+ "embed",
87
+ "form",
88
+ "button",
89
+ "input",
90
+ "textarea",
91
+ "select",
92
+ "link",
93
+ "meta",
94
+ "svg",
95
+ "math",
96
+ "canvas",
97
+ "template",
98
+ "noscript",
99
+ "video",
100
+ "audio",
101
+ "source",
102
+ ]);
103
+
104
+ const ALLOWED_STYLE_PROPERTIES = new Set([
105
+ "font",
106
+ "font-family",
107
+ "font-size",
108
+ "font-weight",
109
+ "font-style",
110
+ "color",
111
+ "text-align",
112
+ "line-height",
113
+ "letter-spacing",
114
+ "text-decoration",
115
+ "text-decoration-color",
116
+ "text-decoration-line",
117
+ "text-decoration-style",
118
+ "text-indent",
119
+ "background",
120
+ "background-color",
121
+ "border",
122
+ "border-top",
123
+ "border-right",
124
+ "border-bottom",
125
+ "border-left",
126
+ "border-top-color",
127
+ "border-top-style",
128
+ "border-top-width",
129
+ "border-right-color",
130
+ "border-right-style",
131
+ "border-right-width",
132
+ "border-bottom-color",
133
+ "border-bottom-style",
134
+ "border-bottom-width",
135
+ "border-left-color",
136
+ "border-left-style",
137
+ "border-left-width",
138
+ "border-color",
139
+ "border-width",
140
+ "border-style",
141
+ "border-radius",
142
+ "border-top-left-radius",
143
+ "border-top-right-radius",
144
+ "border-bottom-right-radius",
145
+ "border-bottom-left-radius",
146
+ "border-collapse",
147
+ "padding",
148
+ "padding-top",
149
+ "padding-right",
150
+ "padding-bottom",
151
+ "padding-left",
152
+ "margin",
153
+ "margin-top",
154
+ "margin-right",
155
+ "margin-bottom",
156
+ "margin-left",
157
+ "width",
158
+ "min-width",
159
+ "max-width",
160
+ "height",
161
+ "max-height",
162
+ "display",
163
+ "vertical-align",
164
+ "list-style",
165
+ "list-style-type",
166
+ "list-style-position",
167
+ "white-space",
168
+ "white-space-collapse",
169
+ "text-wrap-mode",
170
+ "text-wrap-style",
171
+ "word-break",
172
+ "word-wrap",
173
+ "overflow-wrap",
174
+ "overflow",
175
+ "overflow-x",
176
+ "overflow-y",
177
+ "box-sizing",
178
+ "table-layout",
179
+ "text-size-adjust",
180
+ "-webkit-text-size-adjust",
181
+ ]);
182
+
183
+ const ALLOWED_DISPLAY_VALUES = new Set([
184
+ "block",
185
+ "inline",
186
+ "inline-block",
187
+ "list-item",
188
+ "table",
189
+ "table-row",
190
+ "table-cell",
191
+ "table-row-group",
192
+ "table-header-group",
193
+ "none",
194
+ ]);
195
+
196
+ function setNodeKind(element: HTMLElement, kind: string): void {
197
+ element.dataset.wechatNode = kind;
198
+ }
199
+
200
+ function replaceTag(element: HTMLElement, tagName: string): HTMLElement {
201
+ const replacement = element.ownerDocument.createElement(tagName);
202
+ for (const attribute of Array.from(element.attributes)) {
203
+ replacement.setAttribute(attribute.name, attribute.value);
204
+ }
205
+ while (element.firstChild) {
206
+ replacement.appendChild(element.firstChild);
207
+ }
208
+ element.replaceWith(replacement);
209
+ return replacement;
210
+ }
211
+
212
+ function isExternalLink(href: string): boolean {
213
+ return /^(?:https?:)?\/\//i.test(href);
214
+ }
215
+
216
+ function imageIsOnlyContent(parent: HTMLElement, image: HTMLElement): boolean {
217
+ return Array.from(parent.childNodes).every((node) => {
218
+ if (node === image) return true;
219
+ return node.nodeType === 3 && !(node.nodeValue ?? "").trim();
220
+ });
221
+ }
222
+
223
+ const imageRenderer: WechatElementRenderer = {
224
+ kind: "image",
225
+ selector: "img",
226
+ finalizeSelector: "figure, figcaption",
227
+ prepare(element, context) {
228
+ setNodeKind(element, "image");
229
+ const src = element.getAttribute("src");
230
+ if (src) element.setAttribute("data-src", src);
231
+
232
+ const parent = element.parentElement;
233
+ if (!parent || parent.tagName.toLowerCase() !== "p" || !imageIsOnlyContent(parent, element)) {
234
+ return;
235
+ }
236
+
237
+ const figure = context.document.createElement("figure");
238
+ setNodeKind(figure, "image-block");
239
+ parent.replaceWith(figure);
240
+ figure.appendChild(element);
241
+
242
+ const caption = element.getAttribute("title")?.trim();
243
+ element.removeAttribute("title");
244
+ if (caption) {
245
+ const figcaption = context.document.createElement("figcaption");
246
+ setNodeKind(figcaption, "image-caption");
247
+ figcaption.textContent = caption;
248
+ figure.appendChild(figcaption);
249
+ }
250
+ },
251
+ finalize(element) {
252
+ const tagName = element.tagName.toLowerCase();
253
+ if (tagName === "figure") replaceTag(element, "section");
254
+ if (tagName === "figcaption") replaceTag(element, "p");
255
+ },
256
+ };
257
+
258
+ const codeBlockRenderer: WechatElementRenderer = {
259
+ kind: "code-block",
260
+ selector: "pre",
261
+ prepare(element, context) {
262
+ setNodeKind(element, "code-block-body");
263
+ const code = element.querySelector<HTMLElement>("code");
264
+ if (code) setNodeKind(code, "code-block-code");
265
+
266
+ const wrapper = context.document.createElement("section");
267
+ setNodeKind(wrapper, "code-block");
268
+ element.replaceWith(wrapper);
269
+
270
+ const language = element.getAttribute("data-language")?.trim();
271
+ if (language) {
272
+ const label = context.document.createElement("p");
273
+ setNodeKind(label, "code-language");
274
+ label.textContent = language;
275
+ wrapper.appendChild(label);
276
+ }
277
+ wrapper.appendChild(element);
278
+ },
279
+ };
280
+
281
+ const inlineCodeRenderer: WechatElementRenderer = {
282
+ kind: "inline-code",
283
+ selector: "code:not(pre code)",
284
+ prepare(element) {
285
+ setNodeKind(element, "inline-code");
286
+ },
287
+ finalize(element) {
288
+ replaceTag(element, "span");
289
+ },
290
+ };
291
+
292
+ const headingRenderer: WechatElementRenderer = {
293
+ kind: "heading",
294
+ selector: "h1, h2, h3, h4, h5, h6",
295
+ prepare(element) {
296
+ setNodeKind(element, `heading-${element.tagName.slice(1)}`);
297
+ },
298
+ finalize(element) {
299
+ replaceTag(element, "section");
300
+ },
301
+ };
302
+
303
+ const paragraphRenderer: WechatElementRenderer = {
304
+ kind: "paragraph",
305
+ selector: "p",
306
+ prepare(element) {
307
+ if (!element.dataset.wechatNode) setNodeKind(element, "paragraph");
308
+ },
309
+ };
310
+
311
+ const emphasisRenderer: WechatElementRenderer = {
312
+ kind: "emphasis",
313
+ selector: "strong, b, em, i, s, del, u",
314
+ prepare(element) {
315
+ setNodeKind(element, element.tagName.toLowerCase());
316
+ },
317
+ };
318
+
319
+ const blockquoteRenderer: WechatElementRenderer = {
320
+ kind: "blockquote",
321
+ selector: "blockquote",
322
+ prepare(element) {
323
+ setNodeKind(element, "blockquote");
324
+ },
325
+ };
326
+
327
+ /** Normalize URL for reference dedupe (same target → one footnote entry). */
328
+ export function normalizeReferenceUrl(href: string): string {
329
+ const trimmed = href.trim();
330
+ if (!trimmed) return "";
331
+ try {
332
+ const url = new URL(trimmed);
333
+ url.hash = "";
334
+ // Stable host casing; keep path/query as-is except trailing slash noise.
335
+ url.hostname = url.hostname.toLowerCase();
336
+ let path = url.pathname;
337
+ if (path.length > 1 && path.endsWith("/")) {
338
+ path = path.slice(0, -1);
339
+ }
340
+ url.pathname = path;
341
+ return url.toString();
342
+ } catch {
343
+ return trimmed.replace(/\/+$/, "") || trimmed;
344
+ }
345
+ }
346
+
347
+ /**
348
+ * Register or reuse a related-link reference for an external URL.
349
+ * Same URL (even with different anchor text) maps to one index.
350
+ */
351
+ export function resolveLinkReference(
352
+ href: string,
353
+ text: string,
354
+ references: WechatLinkReference[],
355
+ ): WechatLinkReference {
356
+ const normalizedUrl = normalizeReferenceUrl(href);
357
+ const existing = references.find(
358
+ (item) => normalizeReferenceUrl(item.url) === normalizedUrl,
359
+ );
360
+ if (existing) return existing;
361
+
362
+ const reference: WechatLinkReference = {
363
+ index: references.length + 1,
364
+ text: text.trim() || href,
365
+ url: href,
366
+ };
367
+ references.push(reference);
368
+ return reference;
369
+ }
370
+
371
+ const linkRenderer: WechatElementRenderer = {
372
+ kind: "link",
373
+ selector: "a",
374
+ prepare(element, context) {
375
+ const href = element.getAttribute("href")?.trim() ?? "";
376
+ if (!isExternalLink(href)) {
377
+ setNodeKind(element, "internal-link");
378
+ return;
379
+ }
380
+
381
+ const reference = resolveLinkReference(
382
+ href,
383
+ element.textContent?.trim() || href,
384
+ context.references,
385
+ );
386
+
387
+ setNodeKind(element, "external-link");
388
+
389
+ const marker = context.document.createElement("span");
390
+ setNodeKind(marker, "link-marker");
391
+ marker.textContent = `[${reference.index}]`;
392
+ element.after(marker);
393
+ },
394
+ finalize(element) {
395
+ if (element.dataset.wechatNode === "external-link") replaceTag(element, "span");
396
+ },
397
+ };
398
+
399
+ const listRenderer: WechatElementRenderer = {
400
+ kind: "list",
401
+ selector: "ul, ol, li",
402
+ prepare(element, context) {
403
+ const tagName = element.tagName.toLowerCase();
404
+ if (tagName === "ul") setNodeKind(element, "bullet-list");
405
+ if (tagName === "ol") setNodeKind(element, "ordered-list");
406
+ if (tagName !== "li") return;
407
+
408
+ const isTask = element.getAttribute("data-item-type") === "task";
409
+ setNodeKind(element, isTask ? "task-list-item" : "list-item");
410
+ if (!isTask) return;
411
+
412
+ const marker = context.document.createElement("span");
413
+ setNodeKind(marker, "task-marker");
414
+ marker.textContent = element.getAttribute("data-checked") === "true" ? "☑" : "☐";
415
+ const content = element.querySelector<HTMLElement>(":scope > p") ?? element;
416
+ content.prepend(marker);
417
+ },
418
+ };
419
+
420
+ const tableRenderer: WechatElementRenderer = {
421
+ kind: "table",
422
+ selector: "table, thead, tbody, tr, th, td",
423
+ prepare(element) {
424
+ setNodeKind(element, element.tagName.toLowerCase());
425
+ },
426
+ };
427
+
428
+ const dividerRenderer: WechatElementRenderer = {
429
+ kind: "divider",
430
+ selector: "hr",
431
+ prepare(element) {
432
+ setNodeKind(element, "divider");
433
+ },
434
+ };
435
+
436
+ const hardBreakRenderer: WechatElementRenderer = {
437
+ kind: "hard-break",
438
+ selector: "br",
439
+ prepare(element) {
440
+ setNodeKind(element, "hard-break");
441
+ },
442
+ };
443
+
444
+ const articleRenderer: WechatElementRenderer = {
445
+ kind: "article",
446
+ selector: ".zzhub-wechat-article",
447
+ prepare(_element, context) {
448
+ if (context.references.length > 0) {
449
+ const references = context.document.createElement("section");
450
+ setNodeKind(references, "references");
451
+
452
+ const title = context.document.createElement("p");
453
+ setNodeKind(title, "references-title");
454
+ title.textContent = "相关链接";
455
+ references.appendChild(title);
456
+
457
+ const list = context.document.createElement("ol");
458
+ setNodeKind(list, "references-list");
459
+ for (const reference of context.references) {
460
+ const item = context.document.createElement("li");
461
+ setNodeKind(item, "reference-item");
462
+ item.textContent = `[${reference.index}] ${reference.text}: ${reference.url}`;
463
+ list.appendChild(item);
464
+ }
465
+ references.appendChild(list);
466
+ context.root.appendChild(references);
467
+ }
468
+
469
+ if (context.theme.footerText) {
470
+ const footer = context.document.createElement("section");
471
+ setNodeKind(footer, "footer");
472
+ const text = context.document.createElement("p");
473
+ setNodeKind(text, "footer-text");
474
+ text.textContent = context.theme.footerText;
475
+ footer.appendChild(text);
476
+ context.root.appendChild(footer);
477
+ }
478
+ },
479
+ };
480
+
481
+ const DEFAULT_RENDERERS: WechatElementRenderer[] = [
482
+ imageRenderer,
483
+ codeBlockRenderer,
484
+ inlineCodeRenderer,
485
+ headingRenderer,
486
+ paragraphRenderer,
487
+ emphasisRenderer,
488
+ blockquoteRenderer,
489
+ linkRenderer,
490
+ listRenderer,
491
+ tableRenderer,
492
+ dividerRenderer,
493
+ hardBreakRenderer,
494
+ articleRenderer,
495
+ ];
496
+
497
+ export function createWechatRendererRegistry(
498
+ overrides: WechatRendererOverrides = {},
499
+ ): WechatElementRenderer[] {
500
+ return DEFAULT_RENDERERS.map((renderer) => overrides[renderer.kind] ?? renderer);
501
+ }
502
+
503
+ function runRendererPhase(
504
+ phase: "prepare" | "finalize",
505
+ renderers: WechatElementRenderer[],
506
+ context: WechatRenderContext,
507
+ ): void {
508
+ for (const renderer of renderers) {
509
+ const handler = renderer[phase];
510
+ if (!handler) continue;
511
+ const selector = phase === "finalize"
512
+ ? renderer.finalizeSelector ?? renderer.selector
513
+ : renderer.selector;
514
+ const elements: HTMLElement[] = [];
515
+ if (context.root.matches(selector)) elements.push(context.root);
516
+ elements.push(...Array.from(context.root.querySelectorAll<HTMLElement>(selector)));
517
+ for (const element of elements) {
518
+ if (element.isConnected || element === context.root) handler(element, context);
519
+ }
520
+ }
521
+ }
522
+
523
+ function themeVariableDeclarations(
524
+ editorVars: Record<string, string>,
525
+ theme: WechatExportTheme,
526
+ ): string {
527
+ const customVariables = Object.entries(editorVars)
528
+ .filter(([name]) => /^--[a-z0-9-_]+$/i.test(name))
529
+ .map(([name, value]) => `${name}: ${value};`)
530
+ .join("\n");
531
+
532
+ return [
533
+ customVariables,
534
+ `--wx-font-family: ${theme.fontFamily};`,
535
+ `--wx-body-color: ${theme.bodyColor};`,
536
+ `--wx-muted-color: ${theme.mutedColor};`,
537
+ `--wx-h2-color: ${theme.h2Color};`,
538
+ `--wx-h3-color: ${theme.h3Color};`,
539
+ `--wx-brand-ink: ${theme.primaryColor};`,
540
+ `--wx-brand-accent: ${editorVars["--brand"] ?? "#ca6093"};`,
541
+ `--wx-divider-color: ${theme.dividerColor};`,
542
+ `--wx-blockquote-border: ${theme.blockquoteBorderColor};`,
543
+ `--wx-body-line-height: ${theme.bodyLineHeight};`,
544
+ `--wx-body-letter-spacing: ${theme.bodyLetterSpacing};`,
545
+ `--wx-soft-surface: ${editorVars["--bg-warm"] ?? "#faf8f9"};`,
546
+ ].filter(Boolean).join("\n");
547
+ }
548
+
549
+ export function buildWechatThemeCss(
550
+ editorVars: Record<string, string>,
551
+ theme: WechatExportTheme,
552
+ ): string {
553
+ return `
554
+ .milkdown .editor {
555
+ ${themeVariableDeclarations(editorVars, theme)}
556
+ ${theme.containerStyle};
557
+ }
558
+ .milkdown .editor [data-wechat-node="footer"] {
559
+ ${theme.footerStyle};
560
+ }
561
+ `;
562
+ }
563
+
564
+ function parseHtml(html: string): Document {
565
+ return new DOMParser().parseFromString(`<!doctype html><html><body>${html}</body></html>`, "text/html");
566
+ }
567
+
568
+ function sanitizeStyle(element: HTMLElement): void {
569
+ const propertyNames: string[] = [];
570
+ for (let index = 0; index < element.style.length; index += 1) {
571
+ const name = element.style.item(index);
572
+ if (name) propertyNames.push(name);
573
+ }
574
+
575
+ for (const property of propertyNames) {
576
+ const value = element.style.getPropertyValue(property).trim();
577
+ const unsafeValue = /(?:url\s*\(|expression\s*\(|javascript:|var\s*\()/i.test(value);
578
+ const unsafeDisplay = property === "display" && !ALLOWED_DISPLAY_VALUES.has(value.toLowerCase());
579
+ if (!ALLOWED_STYLE_PROPERTIES.has(property) || unsafeValue || unsafeDisplay) {
580
+ element.style.removeProperty(property);
581
+ }
582
+ }
583
+
584
+ if (!element.style.cssText.trim()) element.removeAttribute("style");
585
+ }
586
+
587
+ function allowedAttributesFor(element: HTMLElement): Set<string> {
588
+ const tagName = element.tagName.toLowerCase();
589
+ if (tagName === "img") return new Set(["style", "src", "data-src", "alt", "width", "height"]);
590
+ if (tagName === "a") return new Set(["style", "href", "title"]);
591
+ if (tagName === "ol") return new Set(["style", "start"]);
592
+ if (tagName === "th" || tagName === "td") return new Set(["style", "colspan", "rowspan", "align"]);
593
+ return new Set(["style"]);
594
+ }
595
+
596
+ function sanitizeImageUrl(element: HTMLElement, attribute: "src" | "data-src"): void {
597
+ const value = element.getAttribute(attribute)?.trim() ?? "";
598
+ if (!value) {
599
+ element.removeAttribute(attribute);
600
+ return;
601
+ }
602
+
603
+ if (/^(?:javascript|vbscript):/i.test(value)) {
604
+ element.removeAttribute(attribute);
605
+ return;
606
+ }
607
+
608
+ if (/^data:/i.test(value) && !/^data:image\/(?:avif|gif|jpe?g|png|webp);base64,/i.test(value)) {
609
+ element.removeAttribute(attribute);
610
+ }
611
+ }
612
+
613
+ function sanitizeTree(root: HTMLElement): void {
614
+ const elements = [root, ...Array.from(root.querySelectorAll<HTMLElement>("*"))].reverse();
615
+ for (const element of elements) {
616
+ const tagName = element.tagName.toLowerCase();
617
+ if (DROP_WITH_CONTENT.has(tagName)) {
618
+ if (element !== root) element.remove();
619
+ continue;
620
+ }
621
+ if (!ALLOWED_TAGS.has(tagName)) {
622
+ if (element !== root) element.replaceWith(...Array.from(element.childNodes));
623
+ continue;
624
+ }
625
+
626
+ const allowedAttributes = allowedAttributesFor(element);
627
+ for (const attribute of Array.from(element.attributes)) {
628
+ if (!allowedAttributes.has(attribute.name)) element.removeAttribute(attribute.name);
629
+ }
630
+
631
+ if (tagName === "a") {
632
+ const href = element.getAttribute("href") ?? "";
633
+ if (!/^(?:#|https?:\/\/|mailto:|tel:)/i.test(href)) element.removeAttribute("href");
634
+ }
635
+ if (tagName === "img") {
636
+ sanitizeImageUrl(element, "src");
637
+ sanitizeImageUrl(element, "data-src");
638
+ }
639
+ sanitizeStyle(element);
640
+ }
641
+ }
642
+
643
+ export function renderWechatHtml(input: RenderWechatHtmlInput): string {
644
+ const sourceDocument = parseHtml("");
645
+ const compatibilityRoot = sourceDocument.createElement("section");
646
+ compatibilityRoot.className = "milkdown";
647
+
648
+ const root = sourceDocument.createElement("section");
649
+ root.className = "editor zzhub-wechat-article";
650
+ root.lang = "zh-CN";
651
+ setNodeKind(root, "article");
652
+ root.innerHTML = input.semanticHtml;
653
+ compatibilityRoot.appendChild(root);
654
+ sourceDocument.body.appendChild(compatibilityRoot);
655
+
656
+ const references: WechatLinkReference[] = [];
657
+ const renderers = createWechatRendererRegistry(input.renderers);
658
+ runRendererPhase("prepare", renderers, {
659
+ document: sourceDocument,
660
+ root,
661
+ theme: input.theme,
662
+ references,
663
+ });
664
+
665
+ const css = [
666
+ input.baseCss,
667
+ buildWechatThemeCss(input.editorVars ?? {}, input.theme),
668
+ input.customCss ?? "",
669
+ ].filter(Boolean).join("\n");
670
+
671
+ const inlinedHtml = juice.inlineContent(compatibilityRoot.outerHTML, css, {
672
+ applyAttributesTableElements: false,
673
+ applyHeightAttributes: false,
674
+ applyStyleTags: false,
675
+ applyWidthAttributes: false,
676
+ inlinePseudoElements: false,
677
+ preserveFontFaces: false,
678
+ preserveImportant: false,
679
+ preserveKeyFrames: false,
680
+ preserveMediaQueries: false,
681
+ preservePseudos: false,
682
+ removeStyleTags: true,
683
+ resolveCSSVariables: true,
684
+ });
685
+
686
+ const finalDocument = parseHtml(inlinedHtml);
687
+ const finalRoot = finalDocument.querySelector<HTMLElement>(".zzhub-wechat-article");
688
+ if (!finalRoot) throw new Error("Wechat article root missing after CSS inlining");
689
+
690
+ runRendererPhase("finalize", renderers, {
691
+ document: finalDocument,
692
+ root: finalRoot,
693
+ theme: input.theme,
694
+ references,
695
+ });
696
+ sanitizeTree(finalRoot);
697
+ return finalRoot.outerHTML;
698
+ }