@jacobbubu/md-to-lark 1.3.1 → 1.4.1

package/README.md

@@ -86,6 +86,8 @@ Progress logs and exceptions are written to stderr.
 - Otherwise use `LARK_DOCUMENT_BASE_URL`
 - Otherwise fall back to the current compatibility derivation from `LARK_BASE_URL`
 
+Relative local assets such as `./img-001.png` still resolve against the Markdown file directory by default. If your caller generates a temporary Markdown file elsewhere, use `--resource-base-dir` to keep local asset resolution pinned to the original content directory.
+
 ## Common Commands
 
 Basic publish:
@@ -110,6 +112,7 @@ Presets, Mermaid, and stage artifacts:
 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 ./tmp/generated/article.md --resource-base-dir ./source-assets --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
 ```

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

@@ -1,6 +1,6 @@
 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>] [--resource-base-dir <dir>] [--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).',
@@ -9,6 +9,7 @@ function usage() {
         '  --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). 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).',
+        '  --resource-base-dir Base directory used to resolve relative local image/file paths. Default: the current markdown file directory.',
         '  --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).',
         '  --download-remote-images    Enable prepare-stage remote image pre-download + link rewrite.',
@@ -33,12 +34,14 @@ function usage() {
         '  7) Prepare stage can pre-download remote markdown images and optional yt-dlp URL lines.',
         '  8) Leading YAML/TOML frontmatter is rewritten as fenced code block (yaml/toml), so it stays visible and will not be parsed as headings.',
         '  9) Missing local asset files are skipped/degraded to text fallback; publish will not fail only because a referenced local path is absent.',
+        '  10) Relative local asset paths resolve against the markdown file directory by default; use --resource-base-dir to override that base.',
         '',
         'Examples:',
         '  npm run publish:md -- --input ./docs/a.md',
         '  npm run publish:md -- --input ./docs --title Weekly --folder <token>',
         '  npm run publish:md -- --input ./docs/a.md --doc <document_id>',
         '  npm run publish:md -- --input ./docs/a.md --dry-run',
+        '  npm run publish:md -- --input ./tmp/generated/article.md --resource-base-dir ./original-assets --dry-run',
     ].join('\n');
 }
 export function getPublishMdUsage() {
@@ -53,6 +56,7 @@ export function parsePublishMdArgs(argv, env = process.env) {
     let titleDatePrefix;
     const presetPaths = [];
     let documentBaseUrl = '';
+    let resourceBaseDir = '';
     let folderToken = (env.LARK_FOLDER_TOKEN ?? '').trim();
     let documentId;
     let downloadRemoteImages;
@@ -123,6 +127,14 @@ export function parsePublishMdArgs(argv, env = process.env) {
             i += 1;
             continue;
         }
+        if (arg === '--resource-base-dir') {
+            const value = argv[i + 1];
+            if (!value)
+                throw new Error('Missing value for --resource-base-dir.');
+            resourceBaseDir = value;
+            i += 1;
+            continue;
+        }
         if (arg === '--doc') {
             const value = argv[i + 1];
             if (!value)
@@ -226,6 +238,7 @@ export function parsePublishMdArgs(argv, env = process.env) {
             }
             : {}),
         ...(documentBaseUrl.trim() ? { documentBaseUrl: documentBaseUrl.trim() } : {}),
+        ...(resourceBaseDir.trim() ? { resourceBaseDir: resourceBaseDir.trim() } : {}),
         folderToken,
         ...(documentId ? { documentId: documentId.trim() } : {}),
         ...(downloadRemoteImages === undefined ? {} : { downloadRemoteImages }),

package/dist/lark/docx/ops.js

@@ -511,7 +511,7 @@ export function isRelationMismatchError(error) {
         return false;
     return /1770013|relation mismatch/i.test(error.message);
 }
-export async function replaceImageBlock(client, documentId, blockId, imageToken, authOptions, limiter) {
+export async function replaceImageBlock(client, documentId, blockId, imageToken, imageOptions, authOptions, limiter) {
     await limiter.wait();
     const response = await withRetry('docx.documentBlock.batchUpdate(replace_image)', async () => client.docx.documentBlock.batchUpdate({
         path: {
@@ -523,6 +523,11 @@ export async function replaceImageBlock(client, documentId, blockId, imageToken,
                     block_id: blockId,
                     replace_image: {
                         token: imageToken,
+                        ...(typeof imageOptions.width === 'number' ? { width: imageOptions.width } : {}),
+                        ...(typeof imageOptions.height === 'number' ? { height: imageOptions.height } : {}),
+                        ...(typeof imageOptions.align === 'number' ? { align: imageOptions.align } : {}),
+                        ...(imageOptions.caption ? { caption: imageOptions.caption } : {}),
+                        ...(typeof imageOptions.scale === 'number' ? { scale: imageOptions.scale } : {}),
                     },
                 },
             ],

package/dist/lark/docx/render-post-process.js

@@ -25,16 +25,23 @@ export async function applyCreatedImageBlock(client, documentId, createdBlockId,
     const localPath = image && typeof image.local_path === 'string' ? image.local_path : '';
     if (!localPath)
         return null;
+    const replaceOptions = {
+        ...(image && typeof image.width === 'number' ? { width: image.width } : {}),
+        ...(image && typeof image.height === 'number' ? { height: image.height } : {}),
+        ...(image && typeof image.align === 'number' ? { align: image.align } : {}),
+        ...(image && toObjectRecord(image.caption) ? { caption: toObjectRecord(image.caption) } : {}),
+        ...(image && typeof image.scale === 'number' ? { scale: image.scale } : {}),
+    };
     let imageToken = await uploadBinaryToNode(client, 'docx_image', createdBlockId, localPath, authOptions, mediaLimiter);
     try {
-        await replaceImageBlock(client, documentId, createdBlockId, imageToken, authOptions, docxLimiter);
+        await replaceImageBlock(client, documentId, createdBlockId, imageToken, replaceOptions, authOptions, docxLimiter);
     }
     catch (error) {
         if (!isRelationMismatchError(error)) {
             throw error;
         }
         imageToken = await uploadBinaryToNode(client, 'docx_image', createdBlockId, localPath, authOptions, mediaLimiter);
-        await replaceImageBlock(client, documentId, createdBlockId, imageToken, authOptions, docxLimiter);
+        await replaceImageBlock(client, documentId, createdBlockId, imageToken, replaceOptions, authOptions, docxLimiter);
     }
     return {
         kind: 'image',

package/dist/last/image-defaults.js

@@ -0,0 +1,9 @@
+export const DEFAULT_IMAGE_WIDTH = 1000;
+export const DEFAULT_TABLE_CELL_IMAGE_WIDTH = 240;
+export function createDefaultImagePayload(parentType) {
+    return {
+        width: parentType === 'table_cell' ? DEFAULT_TABLE_CELL_IMAGE_WIDTH : DEFAULT_IMAGE_WIDTH,
+        token: '',
+        align: 'left',
+    };
+}

package/dist/pipeline/hast-to-last.js

@@ -1,4 +1,5 @@
 import { toString } from 'hast-util-to-string';
+import { createDefaultImagePayload } from '../last/image-defaults.js';
 import { LAST_TEXTUAL_BLOCK_TYPE_SET } from '../last/textual-block-types.js';
 const BLOCK_CONTAINER_TAGS = new Set([
     'article',
@@ -146,17 +147,13 @@ function createDividerBlock(ctx, parentId) {
 }
 function createImageBlock(ctx, parentId, sourceUrl) {
     const blockId = nextBlockId(ctx);
+    const parentBlock = ctx.blocks[parentId];
     const blockBase = {
         id: blockId,
         type: 'image',
         parentId,
         children: [],
-        payload: {
-            width: 0,
-            height: 0,
-            token: '',
-            align: 'left',
-        },
+        payload: createDefaultImagePayload(parentBlock?.type),
     };
     if (sourceUrl) {
         blockBase.selector = { attrs: { sourceUrl } };

package/dist/publish/asset-adapter.js

@@ -1,5 +1,6 @@
 import { existsSync } from 'node:fs';
 import path from 'node:path';
+import { createDefaultImagePayload } from '../last/image-defaults.js';
 import { createDefaultMarks, extractTextFromInlines, firstInlineLinkUrl, getPathExtension, inferMediaKind, isTextualBlock, resolveLocalPathFromSource, shouldUsePreviewView, stripQueryAndHash, } from './common.js';
 export function applyStandaloneAttachmentTransforms(last, baseDir) {
     const localAssetByBlockId = new Map();
@@ -26,18 +27,14 @@ export function applyStandaloneAttachmentTransforms(last, baseDir) {
         const displayName = extractTextFromInlines(block.payload.inlines).trim();
         const fileName = displayName.length > 0 ? displayName : path.basename(stripQueryAndHash(linkUrl));
         if (mediaKind === 'image') {
+            const parentBlock = block.parentId ? last.blocks[block.parentId] : undefined;
             const transformed = {
                 id: block.id,
                 ...(block.bttId ? { bttId: block.bttId } : {}),
                 type: 'image',
                 parentId: block.parentId,
                 children: [],
-                payload: {
-                    width: 0,
-                    height: 0,
-                    token: '',
-                    align: 'left',
-                },
+                payload: createDefaultImagePayload(parentBlock?.type),
                 selector: {
                     attrs: {
                         sourceUrl: linkUrl,

package/dist/publish/process-file.js

@@ -69,6 +69,7 @@ export async function processSingleMarkdownFile(params) {
     const stagePaths = buildPipelineStagePaths(runtime.pipelineCacheRootDir, markdownPath);
     const startedAt = new Date().toISOString();
     const sourceMarkdown = await readFile(markdownPath, 'utf8');
+    const resourceBaseDir = runtime.resourceBaseDir ?? path.dirname(markdownPath);
     let markdown = sourceMarkdown;
     for (let presetIndex = 0; presetIndex < runtime.markdownPresets.length; presetIndex += 1) {
         const preset = runtime.markdownPresets[presetIndex];
@@ -82,6 +83,7 @@ export async function processSingleMarkdownFile(params) {
     }
     await writeSourceStage(stagePaths, sourceMarkdown, markdown, {
         sourcePath: path.resolve(markdownPath),
+        resourceBaseDir,
         preset: runtime.markdownPresets.length === 1 ? runtime.markdownPresets[0].displayPath : null,
         presets: runtime.markdownPresets.map((preset) => preset.displayPath),
         startedAt,
@@ -106,8 +108,7 @@ export async function processSingleMarkdownFile(params) {
     });
     await writeLastStage(stagePaths, last);
     ensureLastBlockBttIds(last);
-    const baseDir = path.dirname(markdownPath);
-    const localAssetByBlockId = applyStandaloneAttachmentTransforms(last, baseDir);
+    const localAssetByBlockId = applyStandaloneAttachmentTransforms(last, resourceBaseDir);
     applyTableColumnWidthHeuristics(last);
     const mermaidByBlockId = collectMermaidPatches(last);
     const btt = convertLASTToBTT(last, {

package/dist/publish/runtime.js

@@ -77,6 +77,7 @@ export function buildPublishRuntime(options, env, markdownPresets) {
             ? env.LARK_DOCUMENT_BASE_URL.trim()
             : deriveLarkDocumentBaseUrl(config.baseUrl);
     const documentBaseUrl = normalizeLarkDocumentBaseUrl(documentBaseUrlCandidate);
+    const resourceBaseDir = options.resourceBaseDir?.trim() ? path.resolve(options.resourceBaseDir.trim()) : null;
     const prepareTimeoutMs = toPositiveInt(Number((env.PREPARE_TIMEOUT_MS ?? '').trim())) ?? 15_000;
     const prepareMaxRetries = toNonNegativeInt(Number((env.PREPARE_MAX_RETRIES ?? '').trim())) ?? 3;
     const prepareBackoffBaseMs = toPositiveInt(Number((env.PREPARE_BACKOFF_BASE_MS ?? '').trim())) ?? 500;
@@ -103,6 +104,7 @@ export function buildPublishRuntime(options, env, markdownPresets) {
         markdownPresets,
         markdownPreset: markdownPresets[0] ?? null,
         documentBaseUrl,
+        resourceBaseDir,
         documentUrlFor: (documentId) => buildLarkDocumentUrl(documentBaseUrl, documentId),
         authOptions,
         sdkClient,
@@ -137,6 +139,9 @@ 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.resourceBaseDir) {
+        console.error(`Local asset base override: ${runtime.resourceBaseDir}`);
+    }
     if (runtime.markdownPresets.length > 1) {
         console.error(`Presets: ${runtime.markdownPresets.map((preset) => preset.displayPath).join(' -> ')}`);
         return;

package/package.json

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