@im-nobsidian/core 0.19.1 → 0.20.0

package/dist/index.d.ts

@@ -603,8 +603,8 @@ interface PullResult {
      */
     readonly relinkPending?: true;
     /**
-     * dry-run 만 — 이번 pull 이 새로 찾을 DB(처음 훑는 볼트 · 새로 받을 페이지 안의 DB)의 행은 세지 않았다. 받아 봐야 그 DB 가
-     * 있는지 안다. 없으면 생략.
+     * dry-run 만 — 본문을 읽지 않은 새 페이지 안의 DB 행은 세지 않았다. 받아 봐야 그 DB 가 있는지 안다. 루트 아래 · 미리 보며
+     * 읽은 본문 안의 새 DB 는 센다. 없으면 생략.
      */
     readonly undiscoveredDatabases?: true;
     /**
@@ -3105,6 +3105,16 @@ declare class ImageHandler {
     private readonly downloadTimeoutMs;
     constructor(vaultFs: VaultFS, attachmentFolder?: string, notionClient?: NotionClient | undefined, customFetch?: typeof globalThis.fetch, options?: MediaOptions, stateDb?: IStateDB | undefined);
     private get fetchFn();
+    /** {@link preview} 안에서 도는 중인 렌더 수 — 0 보다 크면 받은 미디어를 볼트에 쓰지 않고 상태 DB 에 적지 않는다. */
+    private previewDepth;
+    /**
+     * 받기를 미리 본다(dry-run) — 미디어를 실제 pull 처럼 받아 이름(내용 해시)과 임베드를 정하되 볼트에 쓰지 않고 상태 DB 에
+     * 적지 않는다. 받지 않고 렌더하면 미디어가 원격 주소로 남아, 받은 글을 볼트의 노트와 견줄 수 없다.
+     */
+    preview<T>(run: () => Promise<T>): Promise<T>;
+    private get previewing();
+    /** 받은 파일을 볼트에 쓴다 — 미리 보기에서는 쓰지 않는다({@link preview}). */
+    private writeDownload;
     /** 상한 로직은 첨부 경로와 공유한다 — 한쪽만 빠뜨리지 않도록(utils/download-fetch). */
     private fetchForDownload;
     downloadImage(url: string, pageTitle: string): Promise<ImageDownloadResult>;
@@ -3651,6 +3661,8 @@ interface PlannedRow {
     readonly resolution?: PlannedResolution;
     /** `create` 만 — 상태 기록에 없던 같은 자리의 행 노트를 다시 잇는다(P7). 새로 받는 것으로 세지 않는다. */
     readonly relink?: true;
+    /** 다시 잇되 글이 달라 충돌로 남긴다 — `relink` 와 같이. */
+    readonly relinkConflict?: Conflict;
 }
 /**
  * 로컬도 고친 노트를 실제 pull 이 어떻게 처리하나 — 충돌로 남김 · 합침(merge) · 받지 않음(원격이 그대로거나
@@ -4040,11 +4052,15 @@ declare class DatabaseSyncer {
      */
     private claimExistingRow;
     /**
-     * 상태 기록에 없던 행 노트를 이 행과 다시 잇는다(P7) — 페이지의 `relinkExistingNote` 와 같은 규칙. 글이 같으면 잇고, 다르면
-     * 이 행 id 를 단 이름은 충돌 전략을 따르고 · 자연 이름은 이은 노트가 없는 볼트에서만 충돌로 잇는다. 잇지 않으면 null.
-     * remote-first 는 `"write"` — 호출측이 받은 행으로 덮는다.
+     * 상태 기록에 없던 행 노트를 이 행과 다시 잇는다(P7) — 받은 글과 견줘 {@link relinkOutcome} 대로. 잇지 않으면 null.
+     * 원격으로 덮을 것은 `"write"` — 호출측이 받은 행으로 덮는다.
      */
     private relinkExistingRow;
+    /**
+     * dry-run — 실제 pull 이 상태 기록에 없던 이 행 노트를 다시 잇나(P7). 받은 행을 실제 pull 처럼 렌더하되 볼트 · 상태 DB 는
+     * 바꾸지 않고({@link ImageHandler.preview}) 견준다. 잇지 않으면 null(새 이름으로 받는다), 충돌로 남길 것이면 그 충돌.
+     */
+    private plannedRowRelink;
     /** 이번 받기에서 로컬 편집을 합친 행의 경로를 가져가고 비운다. */
     takeMergedRows(): string[];
     /**