@jacobbubu/md-to-lark 1.2.0 → 1.3.0

package/README.md

@@ -23,7 +23,7 @@ Notes:
 - Recursively publishing multiple `.md` files from a directory
 - Preparing local assets, remote images, and standalone URLs before publish
 - Running a full dry-run without writing to Feishu
-- Rewriting Markdown before publish with presets
+- Rewriting Markdown before publish with one or more ordered presets
 
 ## Quick Start
 
@@ -109,6 +109,7 @@ Presets, Mermaid, and stage artifacts:
 ```bash
 npm run publish:md -- --input ./test-md/comp/comp.md --preset medium --dry-run
 npm run publish:md -- --input ./test-md/comp/comp.md --preset zh-format --dry-run
+npm run publish:md -- --input ./test-md/comp/comp.md --preset zh-format --preset ./my-preset.mjs --dry-run
 npm run publish:md -- --input ./test-md/mermaid.md --mermaid-target board --dry-run
 npm run publish:md -- --input ./test-md/comp/comp.md --pipeline-cache-dir ./out/debug-cache --dry-run
 ```
@@ -173,6 +174,7 @@ Guardrails:
 - Mermaid `text-drawing` and `board` output paths
 - Table width heuristics and numeric-column right alignment
 - Chinese Markdown formatting preset (`zh-format`)
+- Ordered preset composition from CLI and programmatic usage
 - Stage cache output from `00-source` to `05-publish`
 - Programmatic access through `publishMdToLark`
 

package/dist/commands/publish-md/args.js

@@ -1,13 +1,13 @@
 function usage() {
     return [
-        'Usage: npm run publish:md -- --input <file.md|dir> [--title <doc_title_or_prefix>] [--date-prefix|--no-date-prefix] [--preset <preset_name_or_module_path>] [--document-base-url <base_url>] [--folder <folder_token>] [--doc <document_id>] [--download-remote-images|--no-download-remote-images] [--yt-dlp-path <path>] [--yt-dlp-cookies-path <path>] [--pipeline-cache-dir <dir>] [--mermaid-target <text-drawing|board>] [--mermaid-board-syntax-type <int>] [--mermaid-board-style-type <int>] [--mermaid-board-diagram-type <int>] [--dry-run] [--help|-h]',
+        'Usage: npm run publish:md -- --input <file.md|dir> [--title <doc_title_or_prefix>] [--date-prefix|--no-date-prefix] [--preset <preset_name_or_module_path>]... [--document-base-url <base_url>] [--folder <folder_token>] [--doc <document_id>] [--download-remote-images|--no-download-remote-images] [--yt-dlp-path <path>] [--yt-dlp-cookies-path <path>] [--pipeline-cache-dir <dir>] [--mermaid-target <text-drawing|board>] [--mermaid-board-syntax-type <int>] [--mermaid-board-style-type <int>] [--mermaid-board-diagram-type <int>] [--dry-run] [--help|-h]',
         '',
         'Options:',
         '  --input   Markdown file path, or directory path (publish all *.md recursively).',
         '  --title   Single-file title. In directory mode this is used as title prefix.',
         '  --date-prefix      Enable date prefix in final title: YYYYMMDD-<title>. Default: enabled.',
         '  --no-date-prefix   Disable date prefix in final title.',
-        '  --preset  Optional preset module path (js/mjs/cjs/ts) or built-in name (e.g. medium). Used to transform markdown before publish pipeline.',
+        '  --preset  Optional preset module path (js/mjs/cjs/ts) or built-in name (e.g. medium). Repeatable; presets run in the given order before publish pipeline.',
         '  --document-base-url Base URL used to build documentUrl results (for example https://li.feishu.cn).',
         '  --folder  Feishu folder token. Default: LARK_FOLDER_TOKEN from .env',
         '  --doc     Existing Feishu document id (single-file only). If set, publish directly into this doc (and clear content first).',
@@ -51,7 +51,7 @@ export function parsePublishMdArgs(argv, env = process.env) {
     let inputPath = '';
     let title = '';
     let titleDatePrefix;
-    let presetPath = '';
+    const presetPaths = [];
     let documentBaseUrl = '';
     let folderToken = (env.LARK_FOLDER_TOKEN ?? '').trim();
     let documentId;
@@ -111,7 +111,7 @@ export function parsePublishMdArgs(argv, env = process.env) {
             const value = argv[i + 1];
             if (!value)
                 throw new Error('Missing value for --preset.');
-            presetPath = value;
+            presetPaths.push(value);
             i += 1;
             continue;
         }
@@ -214,11 +214,17 @@ export function parsePublishMdArgs(argv, env = process.env) {
     if (!documentId && !folderToken) {
         throw new Error('Folder token is required when --doc is not provided. Use --folder or set LARK_FOLDER_TOKEN.');
     }
+    const normalizedPresetPaths = presetPaths.map((presetPath) => presetPath.trim()).filter(Boolean);
     return {
         inputPath: inputPath.trim(),
         ...(title.trim() ? { title: title.trim() } : {}),
         ...(titleDatePrefix === undefined ? {} : { titleDatePrefix }),
-        ...(presetPath.trim() ? { presetPath: presetPath.trim() } : {}),
+        ...(normalizedPresetPaths.length > 0
+            ? {
+                ...(normalizedPresetPaths.length === 1 ? { presetPath: normalizedPresetPaths[0] } : {}),
+                presetPaths: normalizedPresetPaths,
+            }
+            : {}),
         ...(documentBaseUrl.trim() ? { documentBaseUrl: documentBaseUrl.trim() } : {}),
         folderToken,
         ...(documentId ? { documentId: documentId.trim() } : {}),

package/dist/commands/publish-md/command.js

@@ -1,11 +1,17 @@
 import { getPublishMdUsage, hasPublishMdHelpFlag, parsePublishMdArgs } from './args.js';
 import { resolvePublishInputSet } from './input-resolver.js';
-import { loadMarkdownPreset } from './preset-loader.js';
+import { loadMarkdownPresets } from './preset-loader.js';
 import { createDocument, listFolderChildren, normalizeDocumentId } from '../../lark/docx/ops.js';
 import { processSingleMarkdownFile } from '../../publish/process-file.js';
 import { buildPublishRuntime, logPublishRuntimeSummary } from '../../publish/runtime.js';
 import { sleep } from '../../shared/rate-limiter.js';
 export { getPublishMdUsage, parsePublishMdArgs };
+function resolveMarkdownPresetRefs(options) {
+    if (options.presetPaths && options.presetPaths.length > 0) {
+        return options.presetPaths.map((presetPath) => presetPath.trim()).filter(Boolean);
+    }
+    return options.presetPath?.trim() ? [options.presetPath.trim()] : [];
+}
 function buildFolderDocIndex(entries) {
     const byTitle = new Map();
     for (const entry of entries) {
@@ -60,11 +66,11 @@ function createFolderDocumentResolver(runtime, options) {
 }
 export async function publishMdToLark(options, env = process.env) {
     const inputSet = await resolvePublishInputSet(options.inputPath);
-    const markdownPreset = await loadMarkdownPreset(options.presetPath);
+    const markdownPresets = await loadMarkdownPresets(resolveMarkdownPresetRefs(options));
     if (options.documentId && inputSet.markdownFiles.length !== 1) {
         throw new Error('--doc only supports single markdown input file.');
     }
-    const runtime = buildPublishRuntime(options, env, markdownPreset);
+    const runtime = buildPublishRuntime(options, env, markdownPresets);
     logPublishRuntimeSummary(runtime, inputSet.markdownFiles.length, inputSet.mode);
     const normalizedDocumentId = options.documentId ? normalizeDocumentId(options.documentId) : undefined;
     const resolveTargetDocumentId = options.dryRun || normalizedDocumentId

package/dist/commands/publish-md/preset-loader.js

@@ -66,7 +66,7 @@ function resolveBuiltInPreset(rawPreset) {
 export function listBuiltinMarkdownPresetNames() {
     return Object.keys(BUILTIN_MARKDOWN_PRESETS);
 }
-export async function loadMarkdownPreset(rawPath) {
+async function loadSingleMarkdownPreset(rawPath) {
     const trimmed = (rawPath ?? '').trim();
     if (!trimmed)
         return null;
@@ -111,3 +111,20 @@ export async function loadMarkdownPreset(rawPath) {
         transform: wrappedTransform,
     };
 }
+export async function loadMarkdownPresets(rawPaths) {
+    const normalized = (rawPaths ?? []).map((rawPath) => rawPath.trim()).filter(Boolean);
+    if (normalized.length === 0)
+        return [];
+    const presets = [];
+    for (const rawPath of normalized) {
+        const preset = await loadSingleMarkdownPreset(rawPath);
+        if (preset) {
+            presets.push(preset);
+        }
+    }
+    return presets;
+}
+export async function loadMarkdownPreset(rawPath) {
+    const presets = await loadMarkdownPresets(rawPath ? [rawPath] : []);
+    return presets[0] ?? null;
+}

package/dist/publish/process-file.js

@@ -70,18 +70,20 @@ export async function processSingleMarkdownFile(params) {
     const startedAt = new Date().toISOString();
     const sourceMarkdown = await readFile(markdownPath, 'utf8');
     let markdown = sourceMarkdown;
-    if (runtime.markdownPreset) {
-        markdown = await runtime.markdownPreset.transform(markdown, {
+    for (let presetIndex = 0; presetIndex < runtime.markdownPresets.length; presetIndex += 1) {
+        const preset = runtime.markdownPresets[presetIndex];
+        markdown = await preset.transform(markdown, {
             inputPath: markdownPath,
             index,
             total: inputSet.markdownFiles.length,
             env: runtime.env,
-            log: (...args) => console.error(`[preset ${index + 1}/${inputSet.markdownFiles.length}]`, ...args.map((arg) => String(arg))),
+            log: (...args) => console.error(`[preset ${presetIndex + 1}/${runtime.markdownPresets.length} file ${index + 1}/${inputSet.markdownFiles.length}] [${preset.displayPath}]`, ...args.map((arg) => String(arg))),
         });
     }
     await writeSourceStage(stagePaths, sourceMarkdown, markdown, {
         sourcePath: path.resolve(markdownPath),
-        preset: runtime.markdownPreset ? runtime.markdownPreset.displayPath : null,
+        preset: runtime.markdownPresets.length === 1 ? runtime.markdownPresets[0].displayPath : null,
+        presets: runtime.markdownPresets.map((preset) => preset.displayPath),
         startedAt,
     });
     const prepareResult = await prepareMarkdownBeforePublish(markdownPath, markdown, {

package/dist/publish/runtime.js

@@ -53,7 +53,7 @@ function normalizeOptionalPath(value) {
     }
     return trimmed;
 }
-export function buildPublishRuntime(options, env, markdownPreset) {
+export function buildPublishRuntime(options, env, markdownPresets) {
     const config = createLarkClientConfigFromEnv(env);
     const sdkClient = new lark.Client({
         appId: config.appId,
@@ -100,7 +100,8 @@ export function buildPublishRuntime(options, env, markdownPreset) {
     };
     return {
         env,
-        markdownPreset,
+        markdownPresets,
+        markdownPreset: markdownPresets[0] ?? null,
         documentBaseUrl,
         documentUrlFor: (documentId) => buildLarkDocumentUrl(documentBaseUrl, documentId),
         authOptions,
@@ -136,6 +137,10 @@ export function logPublishRuntimeSummary(runtime, inputCount, inputMode) {
         ? `Mermaid: target=board syntax_type=${String(runtime.mermaidRenderConfig.board.syntaxType)} style_type=${String(runtime.mermaidRenderConfig.board.styleType ?? '(default)')} diagram_type=${String(runtime.mermaidRenderConfig.board.diagramType ?? '(default)')}`
         : 'Mermaid: target=text-drawing');
     console.error(`Document URL base: ${runtime.documentBaseUrl}`);
+    if (runtime.markdownPresets.length > 1) {
+        console.error(`Presets: ${runtime.markdownPresets.map((preset) => preset.displayPath).join(' -> ')}`);
+        return;
+    }
     if (runtime.markdownPreset) {
         console.error(`Preset: ${runtime.markdownPreset.displayPath}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jacobbubu/md-to-lark",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Publish Markdown to Feishu docs with a stable pipeline.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",