@akairos/pipeline 0.18.5 → 0.19.1

package/src/wechat-preview/browser/editor-export.css

@@ -1,9 +1,9 @@
 /*
  * Thin re-export for tooling that still points at browser/editor-export.css.
- * Canonical source: package @akairos/milkdown-article-style (article.css).
+ * Canonical source: package @akairos/myno (article.css).
  *
  * The Vite export entry imports the package directly (?raw does not resolve
  * @import). Do not add rules here.
  */
 
-@import "@akairos/milkdown-article-style/article.css";
+@import "@akairos/myno/article.css";

package/src/wechat-preview/browser/editor-export.ts

@@ -2,7 +2,7 @@ import { defaultValueCtx, Editor, rootCtx } from "@milkdown/kit/core";
 import { commonmark } from "@milkdown/kit/preset/commonmark";
 import { gfm } from "@milkdown/kit/preset/gfm";
 import { getHTML } from "@milkdown/kit/utils";
-import articleCss from "@akairos/milkdown-article-style/article.css?raw";
+import articleCss from "@akairos/myno/article.css?raw";
 import { getCombinedMilkdownPlugins } from "@akairos/milkdown-article-plugins";
 import type { ArticleStructure } from "../wechat-renderer";
 import { renderWechatHtml } from "../wechat-renderer";

package/src/wechat-preview/browser/studio/myno-editor.ts

@@ -10,8 +10,8 @@ import {
 
 import "@milkdown/crepe/theme/common/style.css";
 import "@milkdown/crepe/theme/frame.css";
-import "@akairos/milkdown-article-style/tokens-default.css";
-import "@akairos/milkdown-article-style/article.css";
+import "@akairos/myno/tokens-default.css";
+import "@akairos/myno/article.css";
 
 export interface MynoEditorOptions {
   root: HTMLElement;

package/src/wechat-preview/browser/studio/studio.ts

@@ -1,4 +1,4 @@
-import articleCss from "@akairos/milkdown-article-style/article.css?raw";
+import articleCss from "@akairos/myno/article.css?raw";
 import { Editor, defaultValueCtx, rootCtx } from "@milkdown/kit/core";
 import { commonmark } from "@milkdown/kit/preset/commonmark";
 import { gfm } from "@milkdown/kit/preset/gfm";

package/src/wechat-preview/index.ts

@@ -100,6 +100,8 @@ export interface ExportMarkdownToWechatHtmlInput {
   timeoutMs?: number;
   /** Write intermediate artifacts for debugging. */
   debugDir?: string;
+  /** 外部插件提供的已构建入口；浏览器和文件输出继续由宿主管理。 */
+  browserScriptPath?: string;
 }
 
 export interface ExportMarkdownToWechatHtmlResult {
@@ -117,9 +119,9 @@ export interface ExportMarkdownToWechatHtmlResult {
 
 const requireFromHere = createRequire(import.meta.url);
 
-/** Absolute path to shared article.css (@akairos/milkdown-article-style). */
+/** Absolute path to shared article.css (@akairos/myno). */
 export function resolveMilkdownArticleStylePath(): string {
-  return requireFromHere.resolve("@akairos/milkdown-article-style/article.css");
+  return requireFromHere.resolve("@akairos/myno/article.css");
 }
 
 /** Source files that feed the browser Vite bundle. */
@@ -405,7 +407,9 @@ export async function exportMarkdownToWechatHtml(
 
     let bundle: BundleAssets;
     try {
-      bundle = ensureBundle();
+      bundle = input.browserScriptPath
+        ? { scriptPath: input.browserScriptPath, rebuilt: false, stale: false }
+        : ensureBundle();
       bundleRebuilt = bundle.rebuilt;
       bundleStale = bundle.stale;
     } catch (error) {
@@ -432,6 +436,7 @@ export async function exportMarkdownToWechatHtml(
         assetBaseUrl: pathToFileURL(`${dirname(resolve(input.markdownPath))}/`).href,
         editorVars: theme.editorVars,
         exportTheme: theme.exportTheme,
+        syntaxPresets,
         customCss,
         structure,
       }),

package/src/wechat-preview/server/http.ts

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
+import { realpath, stat } from "fs/promises";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "path";
 import { z } from "zod";
 import {
   previewBaseUrl,
@@ -32,6 +33,8 @@ import { readArticleTheme } from "../../article-theme";
 import { PipelineConfigSchema, WechatExportThemeOverridesSchema, WechatStructureOverridesSchema } from "../../schema/config";
 import { loadConfig, saveConfig, getPipelineConfigPath, resolveConfigRelativePath } from "../../config";
 import { DIST_DIR, WECHAT_PREVIEW_DIR } from "../../runtime-paths";
+import { resolveMarkdownRenderer } from "../../adapter-loader";
+import type { MarkdownStudioAssets } from "../../adapter-types";
 import type { PreviewRegisterInput } from "./types";
 
 /** 保存入口先校验完整请求，避免写入 CLI 无法加载的配置。 */
@@ -105,6 +108,32 @@ export async function startPreviewServer(
     clearServerLock();
   }
 
+  // 工作台与导出使用同一个插件；没有工作台能力时给出明确提示。
+  const pluginConfig = loadConfig();
+  const externalMarkdown = Boolean(pluginConfig.plugins.markdownRenderer);
+  let studioAssets: Promise<MarkdownStudioAssets | undefined> | undefined;
+  /** 按需加载工作台，故障插件不影响预览登记和历史页面。 */
+  function getStudio() {
+    return studioAssets ??= resolveMarkdownRenderer(pluginConfig).then(async renderer => {
+      const studio = await renderer.studio?.();
+      return studio ? { ...studio, root: await realpath(studio.root) } : undefined;
+    });
+  }
+
+  /** 插件静态资源独立挂载，真实路径也必须留在插件资源目录内。 */
+  async function studioFile(name: string): Promise<string | null> {
+    try {
+      if (!externalMarkdown) return null;
+      const studioRoot = (await getStudio())?.root;
+      if (!studioRoot) return null;
+      const target = await realpath(resolve(studioRoot, name));
+      const rel = relative(studioRoot, target);
+      return rel && !isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`) && (await stat(target)).isFile() ? target : null;
+    } catch {
+      return null;
+    }
+  }
+
   let server: ReturnType<typeof Bun.serve>;
   server = Bun.serve({
     hostname: host,
@@ -317,6 +346,21 @@ export async function startPreviewServer(
       }
 
       if (pathname === "/studio" || pathname === "/studio/" || pathname === "/studio/index.html") {
+        if (externalMarkdown) {
+          let studio: MarkdownStudioAssets | undefined;
+          try { studio = await getStudio(); }
+          catch (error) { return json({ error: error instanceof Error ? error.message : String(error) }, 500); }
+          if (!studio) return html("<h1>当前 Markdown 渲染插件未提供 Studio 工作台。</h1>", 404);
+          const entry = await studioFile(studio.entry);
+          if (!entry) return html("<h1>插件 Studio 入口不存在或超出资源目录。</h1>", 500);
+          // 相对资源按插件入口解析，统一放入命名空间且保留页面导航链接。
+          return html(readFileSync(entry, "utf8").replace(/<(?:script|link)\b[^>]*>/g,
+            tag => tag.replace(/\b(src|href)=(["'])([^"']+)\2/g, (attribute, name, quote, value: string) => {
+              if (/^(?:[a-z][a-z0-9+.-]*:|\/\/|#)/i.test(value)) return attribute;
+              const asset = new URL(value, `http://studio/${studio.entry}`);
+              return `${name}=${quote}/studio-assets${asset.pathname}${asset.search}${quote}`;
+            })));
+        }
         const studioHtmlPath = join(DIST_DIR, "src/wechat-preview/browser/studio/studio.html");
         const fallbackPath = join(DIST_DIR, "studio.html");
         const targetHtmlPath = existsSync(studioHtmlPath) ? studioHtmlPath : fallbackPath;
@@ -326,6 +370,17 @@ export async function startPreviewServer(
         return html("<h1>Studio not built. Run bun run build:wechat-preview first.</h1>", 500);
       }
 
+      if (pathname.startsWith("/studio-assets/")) {
+        let name: string;
+        try { name = decodeURIComponent(pathname.slice("/studio-assets/".length)); }
+        catch { return json({ error: "invalid asset path" }, 400); }
+        const target = await studioFile(name);
+        if (!target) return json({ error: "Studio asset not found" }, 404);
+        return new Response(new Uint8Array(readFileSync(target)), {
+          headers: { "content-type": guessContentType(target), "cache-control": "no-cache" },
+        });
+      }
+
       if (pathname === "/studio.js" || pathname === "/editor-export.js") {
         const filePath = join(DIST_DIR, pathname.slice(1));
         if (existsSync(filePath)) {

package/src/wechat-preview/server/studio.test.ts

@@ -2,7 +2,7 @@ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 
 import { tmpdir } from "os";
 import { join } from "path";
-import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync, writeFileSync } from "fs";
 import { startPreviewServer, type StartPreviewServerResult } from "./http";
 import { loadConfig, saveConfig } from "../../config";
 
@@ -192,4 +192,38 @@ describe("wechat-preview studio server APIs", () => {
     expect(html).toContain("studio.js");
     expect(html).toContain('id="btn-export-config"');
   });
+
+  test("external Studio serves plugin resources without exposing files outside its root", async () => {
+    const root = join(testDir, "plugin-assets");
+    mkdirSync(root);
+    writeFileSync(join(root, "studio.html"), '<script src="/studio.js"></script><link href="/style.css"><a href="/">History</a>');
+    writeFileSync(join(root, "studio.js"), "/* plugin studio */");
+    writeFileSync(join(testDir, "private.txt"), "private");
+    symlinkSync(join(testDir, "private.txt"), join(root, "outside.txt"));
+    const pluginPath = join(testDir, "studio-plugin.mjs");
+    writeFileSync(pluginPath, `export default {name:'studio-test',render(){},studio(){return {root:${JSON.stringify(root)},entry:'studio.html'}}}`);
+    const config = loadConfig();
+    const original = config.plugins.markdownRenderer;
+    config.plugins.markdownRenderer = pluginPath;
+    saveConfig(config);
+    let external: StartPreviewServerResult | undefined;
+    const originalServerDir = process.env.ZZHUB_WECHAT_PREVIEW_DIR;
+    process.env.ZZHUB_WECHAT_PREVIEW_DIR = join(testDir, "external-server");
+    try {
+      external = await startPreviewServer({ host: "127.0.0.1", port: 0, reuseExisting: false });
+      const page = await (await fetch(`${external.url}/studio`)).text();
+      expect(page).toContain('src="/studio-assets/studio.js"');
+      expect(page).toContain('href="/studio-assets/style.css"');
+      expect(page).toContain('<a href="/">History</a>');
+      expect(await (await fetch(`${external.url}/studio-assets/studio.js`)).text()).toBe("/* plugin studio */");
+      expect((await fetch(`${external.url}/studio-assets/outside.txt`)).status).toBe(404);
+      expect((await fetch(`${external.url}/studio-assets/..%2fprivate.txt`)).status).toBe(404);
+      expect((await fetch(`${external.url}/api/studio/config`)).status).toBe(200);
+    } finally {
+      external?.stop?.();
+      process.env.ZZHUB_WECHAT_PREVIEW_DIR = originalServerDir;
+      config.plugins.markdownRenderer = original;
+      saveConfig(config);
+    }
+  });
 });

package/src/wechat-preview/wechat-export.integration.test.ts

@@ -175,6 +175,9 @@ window.__zzhubRenderReady = (async () => {
     expect(html).toContain("![代码示例](./missing-example.png)");
     expect(html).not.toMatch(/<img[^>]+src="\.\.?\//);
     expect(html).toContain("<table");
+    expect(html).toMatch(/<table[^>]*overflow-x: auto/);
+    expect(html).toMatch(/<th\b[^>]*white-space: nowrap/);
+    expect(html).toMatch(/<td\b[^>]*word-break: break-word/);
     expect(html).toContain("<img ");
     expect(html).toContain("图片说明：克制、清晰、适合移动端阅读");
     expect(html).toContain("typescript</p><pre");

package/src/wechat-preview.test.ts

@@ -30,7 +30,7 @@ describe("wechat preview theme mapping", () => {
     //   - it styles both bare <code> (live editor) and the export-only
     //     [data-wechat-node] hooks emitted by wechat-renderer.
     // Exact colors/padding values belong to the external
-    // @akairos/milkdown-article-style package and must NOT be pinned here, or a
+    // @akairos/myno package and must NOT be pinned here, or a
     // package theme bump breaks this repo for no functional reason.
     const { resolveMilkdownArticleStylePath } = await import("./wechat-preview/index");
     const css = await Bun.file(resolveMilkdownArticleStylePath()).text();