@im-nobsidian/core 0.15.0 → 0.17.0

package/dist/index.d.ts

@@ -31,7 +31,6 @@ declare const ConfigSchema: z.ZodObject<{
     notion: z.ZodObject<{
         token: z.ZodString;
         rootPageId: z.ZodString;
-        workspaceId: z.ZodOptional<z.ZodString>;
         parentMode: z.ZodDefault<z.ZodEnum<["page", "database"]>>;
         databaseId: z.ZodOptional<z.ZodString>;
         databases: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -65,12 +64,10 @@ declare const ConfigSchema: z.ZodObject<{
             pullFilter?: unknown;
         }[];
         databaseId?: string | undefined;
-        workspaceId?: string | undefined;
     }, {
         token: string;
         rootPageId: string;
         databaseId?: string | undefined;
-        workspaceId?: string | undefined;
         parentMode?: "page" | "database" | undefined;
         databases?: {
             databaseId: string;
@@ -117,33 +114,30 @@ declare const ConfigSchema: z.ZodObject<{
     paths: z.ZodObject<{
         include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        excludeObsidianOnly: z.ZodDefault<z.ZodBoolean>;
         attachments: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         attachments: string;
         include: string[];
         exclude: string[];
+        excludeObsidianOnly: boolean;
     }, {
         attachments?: string | undefined;
         include?: string[] | undefined;
         exclude?: string[] | undefined;
+        excludeObsidianOnly?: boolean | undefined;
     }>;
     conversion: z.ZodObject<{
         preferMarkdownApi: z.ZodDefault<z.ZodBoolean>;
-        preserveMarkers: z.ZodDefault<z.ZodBoolean>;
-        frontmatterMapping: z.ZodDefault<z.ZodBoolean>;
         imageDownload: z.ZodDefault<z.ZodEnum<["immediate", "lazy", "skip"]>>;
         timeZone: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strip", z.ZodTypeAny, {
         preferMarkdownApi: boolean;
-        preserveMarkers: boolean;
-        frontmatterMapping: boolean;
         imageDownload: "immediate" | "lazy" | "skip";
         timeZone?: string | undefined;
     }, {
         timeZone?: string | undefined;
         preferMarkdownApi?: boolean | undefined;
-        preserveMarkers?: boolean | undefined;
-        frontmatterMapping?: boolean | undefined;
         imageDownload?: "immediate" | "lazy" | "skip" | undefined;
     }>;
     advanced: z.ZodObject<{
@@ -202,7 +196,6 @@ declare const ConfigSchema: z.ZodObject<{
         markdownCompletionMaxBlocks?: number | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    version: 1;
     notion: {
         token: string;
         rootPageId: string;
@@ -215,8 +208,13 @@ declare const ConfigSchema: z.ZodObject<{
             pullFilter?: unknown;
         }[];
         databaseId?: string | undefined;
-        workspaceId?: string | undefined;
     };
+    conversion: {
+        preferMarkdownApi: boolean;
+        imageDownload: "immediate" | "lazy" | "skip";
+        timeZone?: string | undefined;
+    };
+    version: 1;
     sync: {
         notifications: "silent" | "default";
         direction: "push" | "pull" | "both";
@@ -233,13 +231,7 @@ declare const ConfigSchema: z.ZodObject<{
         attachments: string;
         include: string[];
         exclude: string[];
-    };
-    conversion: {
-        preferMarkdownApi: boolean;
-        preserveMarkers: boolean;
-        frontmatterMapping: boolean;
-        imageDownload: "immediate" | "lazy" | "skip";
-        timeZone?: string | undefined;
+        excludeObsidianOnly: boolean;
     };
     advanced: {
         concurrency: number;
@@ -261,12 +253,10 @@ declare const ConfigSchema: z.ZodObject<{
         markdownCompletionMaxBlocks: number;
     };
 }, {
-    version: 1;
     notion: {
         token: string;
         rootPageId: string;
         databaseId?: string | undefined;
-        workspaceId?: string | undefined;
         parentMode?: "page" | "database" | undefined;
         databases?: {
             databaseId: string;
@@ -276,6 +266,12 @@ declare const ConfigSchema: z.ZodObject<{
             titleProperty?: string | undefined;
         }[] | undefined;
     };
+    conversion: {
+        timeZone?: string | undefined;
+        preferMarkdownApi?: boolean | undefined;
+        imageDownload?: "immediate" | "lazy" | "skip" | undefined;
+    };
+    version: 1;
     sync: {
         notifications?: "silent" | "default" | undefined;
         direction?: "push" | "pull" | "both" | undefined;
@@ -292,13 +288,7 @@ declare const ConfigSchema: z.ZodObject<{
         attachments?: string | undefined;
         include?: string[] | undefined;
         exclude?: string[] | undefined;
-    };
-    conversion: {
-        timeZone?: string | undefined;
-        preferMarkdownApi?: boolean | undefined;
-        preserveMarkers?: boolean | undefined;
-        frontmatterMapping?: boolean | undefined;
-        imageDownload?: "immediate" | "lazy" | "skip" | undefined;
+        excludeObsidianOnly?: boolean | undefined;
     };
     advanced: {
         concurrency?: number | undefined;
@@ -425,6 +415,7 @@ interface ProgressItem {
      * 받아 봤지만 볼트에 쓰지 않았다(pull) — 바뀐 것이 없거나 로컬을 지켰다. 진행 수에는 들지만 화면이 바뀐
      * 노트로 적지 않는다. 다시 그리기(B14)는
      * 받아 둔 노트를 모두 받아 보므로, 적으면 바뀌지 않은 노트마다 「updated」 줄이 찍혔다.
+     * push 는 보낼 것이 없던 고침 — 읽기 전용 속성만 고친 행.
      */
     readonly unchanged?: boolean;
 }
@@ -981,6 +972,11 @@ interface IStateDB {
     /** 닫는다 — 파일에 남은 쓰기를 마쳐야 하는 구현(플러그인의 sql.js)은 그 일을 Promise 로 돌려준다. */
     close(): void | Promise<void>;
     getByPath(path: string): SyncRecord | null;
+    /**
+     * 대소문자를 가리지 않고 같은 경로의 기록들 — 받을 이름이 macOS · Windows 에서 다른 노트의 파일과 겹치는지(P9).
+     * SQLite 의 `NOCASE` 라 ASCII 만 접는다. 경로는 NFC 로 적혀 있다(`upgradeNfcPaths`).
+     */
+    getByPathKey(path: string): SyncRecord[];
     getByNotionId(pageId: string): SyncRecord | null;
     getByStatus(status: SyncStatus): SyncRecord[];
     getAll(): SyncRecord[];
@@ -1024,7 +1020,13 @@ interface IStateDB {
 declare class StateDB implements IStateDB {
     private readonly lock;
     private readonly db;
+    /**
+     * 준비한 문장 — SQL 글자마다 한 번만 준비한다. 노트마다 여러 번 부르는 조회(`getByPath` 등)가 부를 때마다 다시
+     * 준비하면 5,000 노트 첫 push 에서 준비만 3초였다(P10 실측). 스키마가 바뀌면 SQLite 가 다시 준비한다.
+     */
+    private readonly statements;
     private constructor();
+    private sql;
     /**
      * 상태 DB 파일을 연다 — 없으면 새로 만든다. 한 볼트의 상태 DB 는 한 곳만 연다 — 플러그인이나 다른 CLI 가 쓰는
      * 중이면 {@link StateDbLockedError} 를 던진다(ADR-026). 저장된 파일이 비었거나 잘렸으면 빈 DB 로 열지 않고
@@ -1052,6 +1054,7 @@ declare class StateDB implements IStateDB {
     /** 닫고 잠금을 푼다 — 닫는 사이 다른 곳이 열지 않게 닫은 뒤에 푼다. */
     close(): void;
     getByPath(path: string): SyncRecord | null;
+    getByPathKey(path: string): SyncRecord[];
     getByNotionId(pageId: string): SyncRecord | null;
     getByStatus(status: SyncStatus): SyncRecord[];
     getAll(): SyncRecord[];
@@ -1206,6 +1209,11 @@ declare const SAVED_STATE_TABLES_QUERY = "SELECT 1 FROM sqlite_master WHERE type
  *   예전 조회(`LIKE '%/노트.md'`)는 슬래시가 앞에 있어야 맞아서 볼트 맨 위 노트와 경로 붙은 링크를 못 찾았다 —
  *   제목이 파일 이름과 다른 노트(파일 이름에 못 쓰는 글자를 바꾼 노트)로 가는 링크가 Notion 에서 글로 남았다.
  * - LIKE 의 `%` · `_` 는 글자로 견준다. 예전에는 `a_b` 가 `a-b.md` 에도 맞았다.
+ * - 링크 글자는 NFC 로 견준다 — 볼트 경로 · 제목이 NFC 다. macOS 에서 붙여 넣은 NFD 글자도 같은 노트로 간다.
+ * - 끝으로 대소문자를 가리지 않고 한 번 더 — Obsidian 은 `[[note]]` 를 `Note.md` 로 잇는다. SQLite 의 `NOCASE` 는
+ *   ASCII 만 접는다.
+ * - 별칭과 경로 꼬리(`%/노트.md`)는 무늬가 `%` 로 시작해 색인을 못 쓴다 — 어디에도 없는 링크(아직 올리지 않은 노트로 가는
+ *   링크)는 그 둘에서 표를 훑는다. 5,000 노트 첫 push 에서 1초 남짓이다(P10 실측) — Notion 요청 시간에 견주면 작다.
  */
 interface WikilinkLookup {
     readonly sql: string;
@@ -2013,7 +2021,13 @@ declare class NotionClient {
      */
     setWikilinkResolver(resolver: WikilinkResolver$1): void;
     extractProperties(page: PageObjectResponse): Record<string, unknown>;
-    private lastRequestTime;
+    /**
+     * 다음 요청이 나갈 수 있는 가장 이른 시각(epoch ms). 요청마다 이 자리를 «먼저 잡고» 기다린다 — 동시 칸
+     * (`concurrency`)이 여럿이어도 시작 간격이 `minRequestInterval` 아래로 내려가지 않는다. 예전에는 칸마다 마지막 요청
+     * 시각을 같이 읽고 같이 잔 뒤 한꺼번에 나가, 350ms 간격(초당 약 3회)이 실제로는 초당 8회 남짓이 되어 큰 볼트의 첫
+     * push 가 429 를 거듭 맞았다(P10 실측 — 1,000 노트에서 Retry-After 40초).
+     */
+    private nextRequestAt;
     /**
      * 429 이후 **클라이언트 전체**가 쉬어야 하는 시각(epoch ms).
      *
@@ -2051,6 +2065,22 @@ declare class NotionClient {
     private waitForTurn;
 }
 
+/** Notion 에 닿는지 확인한 결과 — 읽은 것과 읽지 못한 까닭을 사람이 읽는 줄로. */
+interface NotionAccessCheck {
+    readonly ok: boolean;
+    readonly lines: readonly string[];
+}
+/** 무엇을 확인하나 — 루트 페이지, DB 모드면 그 DB. 빈 값은 건너뛴다. */
+interface NotionAccessTarget {
+    readonly rootPageId: string;
+    readonly databaseId?: string;
+}
+/**
+ * 토큰이 맞는지, 루트 페이지(DB 모드면 DB)를 읽을 수 있는지 Notion 에 묻는다 — 첫 동기화에서야 알던 것을 미리.
+ * 아무것도 쓰지 않는다. 쓰기 권한은 쓰지 않고는 알 수 없어 확인하지 않는다.
+ */
+declare function checkNotionAccess(client: NotionClient, target: NotionAccessTarget): Promise<NotionAccessCheck>;
+
 interface RichTextSegment {
     content: string;
     bold?: boolean;
@@ -2735,7 +2765,7 @@ interface UserBaseFilterFix {
  * 긴 sync(실볼트 pull 500초) 동안 주기 sync 가 쌓인다.
  */
 /** 잠그는 작업 — 볼트 · 상태 DB · 원격을 바꾸거나 이번 실행의 기준을 정하는 것. */
-type GatedOperation = "push" | "pull" | "sync" | "status" | "fetch" | "resolve" | "discard" | "prepare-database" | "base-filters";
+type GatedOperation = "push" | "pull" | "sync" | "status" | "fetch" | "resolve" | "discard" | "prepare-database" | "base-filters" | "verify";
 declare function operationLabel(operation: GatedOperation): string;
 declare class SyncBusyError extends Error {
     /** 이미 도는 작업. */
@@ -2793,6 +2823,16 @@ declare class SyncOrchestrator {
      * 목록에 없으므로, 그대로 돌리면 「볼트에서 지움」 으로 보고 Notion 페이지를 지우거나 되살리려 한다.
      */
     private assertConnectionScope;
+    /**
+     * 예전 CLI 가 적은 NFD 경로를 NFC 로 옮겨 적는다 — 한 번만(`upgradeNfcPaths`). dry-run · status 도 먼저 한다: 상태 기록의
+     * 표기만 고치고 볼트 · Notion 은 그대로다. 안 고치면 그 노트를 지울 것 · 새로 만들 것으로 보인다.
+     */
+    private alignStatePaths;
+    /**
+     * 볼트의 첨부(노트가 아닌 파일)를 폴더 페이지에 올린다(`sync.syncFiles`). 올리지 못한 첨부는 `failed` 에 담는다. 올릴 노트가
+     * 있든 없든 push 마다 부른다 — 바뀌지 않은 첨부는 파일 기록이 건너뛴다.
+     */
+    private pushVaultFiles;
     /**
      * @param mergedByPull sync dry-run 만 — 앞선 pull dry-run 이 합칠 노트. 실제 sync 는 합친 뒤 원격을 본 것으로
      *   적어 push 가 올린다 — dry-run 은 받지 않아 원격이 바뀐 그대로라, 원격을 보고 거절하지 않는다.
@@ -2852,6 +2892,10 @@ declare class SyncOrchestrator {
     recordLocalRename(from: string, to: string, kind: RenameKind): void;
     /** 볼트에서 지운 노트 · 폴더 — 그 자리를 새 경로로 적은 힌트를 버린다. */
     recordLocalDelete(path: string): void;
+    /**
+     * 토큰 · 루트 페이지(DB 모드면 DB)를 읽을 수 있는지 Notion 에 묻는다 — 아무것도 쓰지 않아 동기화와 겹쳐도 된다.
+     */
+    checkNotionAccess(): Promise<NotionAccessCheck>;
     /**
      * 볼트 완결성 검증 — 원격에 있는 것이 볼트에 빠짐없이 있는지 대조한다(R11-B · R12-C).
      *
@@ -2868,6 +2912,7 @@ declare class SyncOrchestrator {
      * 열거와 맞대 봐야 의미가 있다.
      */
     verifyCompleteness(): Promise<VaultCompletenessReport>;
+    private executeVerifyCompleteness;
     fetch(): Promise<{
         newPages: number;
         deletedPages: number;
@@ -2924,10 +2969,26 @@ declare class SyncOrchestrator {
 interface PathFilterConfig {
     readonly include?: string[];
     readonly exclude?: string[];
+    /**
+     * Obsidian 에서만 쓰는 것(Canvas · Excalidraw · 템플릿 폴더)도 뺀다 — `true` 일 때만. 볼트를 여는 쪽(CLI · 플러그인)이
+     * `obsidianOnlyExcludes` 로 패턴을 더한다.
+     */
+    readonly excludeObsidianOnly?: boolean;
 }
+/**
+ * 볼트 경로는 NFC 다 — Obsidian 이 디스크의 NFD 이름(macOS Finder 가 만든 한글 이름 등)을 NFC 로 보이는 것과 같다
+ * (2026-10-31 실측: Obsidian 1.12.4 의 `TFile.path` 는 NFC, NFD · NFC 어느 경로로도 읽힘). 예전 CLI 는 디스크 이름을
+ * 그대로 써서 `[[회의록]]` 이 NFD 이름의 노트를 찾지 못했고, Notion 제목도 NFD 로 올렸다.
+ */
 declare class NodeVaultFS implements VaultFS {
     private readonly rootPath;
     private readonly filter;
+    /**
+     * NFC 볼트 경로 → 디스크의 상대 경로 — ASCII 가 아닌 이름(파일 · 폴더)만. 걸을 때 · 처음 열 때 채운다. 새로 만드는 이름은
+     * NFC 로 쓴다.
+     * Linux 는 두 꼴을 다른 이름으로 보므로 NFC 경로를 그대로 열면 NFD 파일 옆에 새 파일이 생긴다.
+     */
+    private readonly diskPaths;
     /**
      * @param ignoreFile 폴더의 `.im-nobsidian-ignore` 를 따른다 — 볼트 전체를 보는 쪽(다른 연결의 노트에서 링크를 고칠 때)은
      *   그 폴더를 맡은 연결의 제외 목록을 따르지 않는다.
@@ -2949,8 +3010,23 @@ declare class NodeVaultFS implements VaultFS {
     listMarkdownFileStats(): Promise<FileStatInfo[]>;
     getFileStat(path: string): Promise<FileStatInfo | null>;
     listNonMarkdownFiles(): Promise<NonMdFileInfo[]>;
-    /** 볼트 경로 — Windows 의 `relative()` 는 `\` 로 잇는다. 상태 DB · 패턴 · Notion 경로는 모두 `/` 다. */
-    private vaultPath;
+    /**
+     * 한 폴더의 항목과 그 볼트 경로 — 숨김(`.`)은 뺀다. 경로는 `/` 로 잇고(Windows 의 `\\` 가 아니라 — 상태 DB · 패턴 ·
+     * Notion 경로는 모두 `/`), NFD 이름은 NFC 로 보이며 디스크 이름을 적어 둔다.
+     *
+     * 같은 폴더에 NFC 꼴의 이름이 따로 있으면(Linux 에서만 둘 다 있을 수 있다) NFC 경로는 그것의 것이고 NFD 쪽은 디스크
+     * 이름 그대로 — 하나로 접으면 한쪽 노트가 보이지 않고 다른 쪽 파일을 읽는다. 걷는 차례와 무관하게 같은 답이 나온다.
+     */
+    private entriesOf;
+    private full;
+    /**
+     * 볼트 경로의 디스크 이름 — 위 폴더부터 같은 규칙으로. 걸으며 본 이름이면 그것. 아니면(걷기 전에 부른 이름) 디스크에
+     * 그 꼴이 없고 NFC 로 같은 다른 꼴이 있을 때 그것을 쓴다 — Linux 는 두 꼴을 다른 이름으로 보아, 그대로 쓰면 NFD 파일
+     * 옆에 새 파일이 생긴다. ASCII 이름은 보지 않는다.
+     */
+    private onDisk;
+    /** 지운 것 아래의 디스크 이름을 잊는다. */
+    private forget;
     private walkDirNonMd;
     private walkDirStats;
     private walkDir;
@@ -3268,6 +3344,8 @@ declare class FileHandler {
      * 호출이 늘어나는 **합성 경로**라 전체로는 여전히 무한대다. 상한을 넘긴 첨부는 경고만
      * 남기고 나머지 첨부는 계속 올린다 — 첨부 하나가 push 전체를 멎게 하지 않는다.
      *
+     * @param failed 실패를 결과로 알릴 곳 — 있으면 실패를 여기 담고 경고 로그는 내지 않는다(화면이 결과로 알린다. 둘 다
+     *   내면 같은 말이 두 번 나온다). 없으면 경고 로그로만 남는다.
      * @returns 업로드 결과. 변경 없음(스킵)이거나 실패했으면 null.
      */
     private pushSingleFile;
@@ -3283,7 +3361,13 @@ declare class FileHandler {
      * 때마다 같은 요청을 다시 보내 같은 이유로 실패했다(실볼트 `.ipynb` 22개).
      */
     private listUploadableFiles;
-    pushAllFiles(): Promise<FileUploadResult[]>;
+    /**
+     * 볼트의 첨부를 폴더 페이지마다 올린다.
+     *
+     * @param failed 올리지 못한 첨부를 담을 곳 — push 결과의 `failed` 를 넘기면 CLI · 플러그인이 처리하지 못한 것으로
+     *   보인다. 예전엔 경고 로그로만 남아 push 가 「실패 0」 으로 끝났다.
+     */
+    pushAllFiles(failed?: FailedOperation[]): Promise<FileUploadResult[]>;
     downloadFileBlock(url: string, filename: string, targetFolder: string): Promise<FileDownloadResult>;
     downloadFileBlocks(blocks: Array<{
         type: string;
@@ -4560,9 +4644,14 @@ declare function notionIdsEqual(a: string, b: string): boolean;
  * markdown-api 경로(convertPageMentions)가 동일 형태로 수렴하도록 한다(rank20/I3).
  */
 declare function compactNotionId(id: string): string;
+/** 페이지 · DB 를 여는 주소 — 하이픈을 뗀 id 를 붙인다. */
+declare function notionPageUrl(id: string): string;
 declare function shortNotionId(id: string): string;
 
-/** Notion 제목 → 볼트 파일 이름(확장자 없이). */
+/**
+ * Notion 제목 → 볼트 파일 이름(확장자 없이). NFC 로 — 볼트 경로는 NFC 다(`NodeVaultFS`). macOS 에서 NFD 이름으로 올린
+ * 제목도 같은 파일 이름이 된다.
+ */
 declare function sanitizeFileName(name: string): string;
 
 /** 노트(마크다운 파일)의 경로 · 이름인가. */
@@ -4639,6 +4728,35 @@ declare function parseIgnorePatterns(content: string): string[];
 /** 운영체제 구분자로 이은 상대 경로 → 볼트 경로(`/`). `relative()` 의 결과에 쓴다. */
 declare function toVaultPath(relativePath: string, separator: string): string;
 
+/**
+ * Obsidian 에서만 쓰는 것 — 기본으로 동기화하지 않는다(`paths.excludeObsidianOnly`, D10).
+ *
+ * - Canvas(`.canvas`) · Excalidraw(`.excalidraw.md` · `.excalidraw`) 는 JSON 이다. 노트로 올리면 Notion 에 수천 줄의 JSON 이
+ *   생기고, 첨부로 올리면 Notion 에서 열 수 없는 파일 블록이 된다. Notion 에 그 그림을 그릴 곳이 없다.
+ * - 템플릿 폴더의 노트는 `{{date}}` · `<% tp.date.now() %>` 같은 자리 표시를 품은 틀이다 — Notion 에 올려도 쓸 곳이 없고
+ *   Notion 의 페이지 목록만 어지럽힌다. 폴더는 Obsidian 의 설정에서 읽는다(코어 「템플릿」 · Templater).
+ *
+ * 이미 동기화한 노트를 빼도 Notion 페이지는 지우지 않는다 — 제외한 노트는 「볼트에서 지움」 으로 보지 않는다.
+ */
+declare const OBSIDIAN_ONLY_PATTERNS: readonly string[];
+/** 템플릿 폴더를 적는 Obsidian 설정 — Obsidian 설정 폴더(`.obsidian`) 기준 파일과 그 키. */
+declare const TEMPLATE_FOLDER_SETTINGS: ReadonlyArray<{
+    readonly file: string;
+    readonly key: string;
+}>;
+/**
+ * 설정 파일의 글에서 템플릿 폴더(볼트 기준)를 읽는다. 없거나 깨졌거나 비었으면 뺀다 — 폴더를 정하지 않은 템플릿은 볼트
+ * 맨 위를 가리키지 않는다(Obsidian 은 고르지 않은 것으로 본다).
+ *
+ * @param contents `TEMPLATE_FOLDER_SETTINGS` 의 파일 → 글(없으면 null)
+ */
+declare function templateFolders(contents: (file: string) => string | null): string[];
+/**
+ * 이 연결 폴더(볼트 맨 위면 `""`)의 제외 패턴 — 템플릿 폴더는 연결 폴더 기준으로 옮긴다. 연결 밖의 템플릿 폴더는 뺀다. 연결
+ * 폴더가 템플릿 폴더이거나 그 안이면 템플릿 폴더를 빼지 않는다 — 그 폴더를 일부러 연결한 것이다.
+ */
+declare function obsidianOnlyExcludes(templates: readonly string[], folder: string): string[];
+
 /** 줄 비교의 한 줄. 번호는 1부터 — 더한 줄은 옛 번호가, 지운 줄은 새 번호가 없다. */
 interface DiffLine {
     readonly kind: "same" | "added" | "removed";
@@ -4690,6 +4808,31 @@ interface Logger {
 declare function setLogger(logger: Logger): void;
 declare function getLogger(): Logger;
 
+/**
+ * lookbehind 없이 앞 글을 보는 정규식 — 소스에 `(?<!…)` · `(?<=…)` 를 쓰지 않는다.
+ *
+ * iOS 16.4 앞의 JavaScript 는 lookbehind 를 읽지 못해, 그런 정규식 하나가 든 스크립트 전체가 뜨지 않는다 — 플러그인이
+ * 모바일에서 아예 켜지지 않는다(P11). 커뮤니티 디렉터리의 검사도 데스크톱 전용이 아닌 플러그인의 lookbehind 를
+ * 거절한다. `tests/utils/no-lookbehind.test.ts` 가 소스에 다시 들어오지 않게 막는다.
+ *
+ * `exec` 만 갈아 끼운다 — `replace` · `matchAll` · `split` · `test` 가 모두 `exec` 를 부르므로 쓰는 곳은 바뀌지 않는다.
+ * 맞은 자리의 앞 글이 조건에 맞지 않으면 그 자리를 버리고 다음 글자에서 다시 찾는다. 정규식 맨 앞(또는 마지막
+ * 갈래의 맨 앞)의 lookbehind 와 결과가 같다 — 엔진도 그 자리에서 lookbehind 가 막히면 다음 글자로 넘어간다.
+ */
+/** 맞은 것을 받나 — `index` 는 맞은 자리, `match` 는 맞은 것(갈래를 가를 때). */
+type Lookbehind = (text: string, index: number, match: RegExpExecArray) => boolean;
+declare class LookbehindRegExp extends RegExp {
+    readonly accept: Lookbehind;
+    /** 실제로 찾는 정규식 — `g`(또는 `y`) 로 어느 자리에서든 이어 찾는다. */
+    private readonly scanner;
+    constructor(pattern: string | RegExp, flags?: string, accept?: Lookbehind);
+    exec(text: string): RegExpExecArray | null;
+}
+/** `index` 바로 앞의 글자(써로게이트 쌍은 하나로) — 맨 앞이면 "". */
+declare function charBefore(text: string, index: number): string;
+/** `(?<![…])` — 바로 앞 글자가 `set`(글자 하나를 보는 정규식)에 맞지 않거나 맨 앞이다. */
+declare function notAfter(set: RegExp): Lookbehind;
+
 /**
  * 경로 패턴(`paths.include` · `paths.exclude` · `.im-nobsidian-ignore`)을 목록에 대는 VaultFS.
  *
@@ -4840,6 +4983,8 @@ declare const DB_VIEWS_PATH = ".im-nobsidian/db-views.json";
 declare const STATE_DB_PATH = ".im-nobsidian/sync.db";
 /** 파일 감시에서 제외할 내부 디렉터리 glob. */
 declare const INTERNAL_DIR_GLOB = "**/.im-nobsidian/**";
+/** DB 사이드카 파일 확장자 — `<DB 이름>.notion.json`. */
+declare const SIDECAR_SUFFIX = ".notion.json";
 /** Obsidian 설정 폴더 기본 이름(볼트 맨 위). 사용자가 바꿀 수 있어 플러그인은 `vault.configDir` 를 쓴다. */
 declare const OBSIDIAN_CONFIG_DIR = ".obsidian";
 /**
@@ -4976,4 +5121,4 @@ declare function readColumnLayout(lines: readonly string[]): (ColumnPlace | unde
 /** 열 이름표 — `열 2/3 · 50%`. 비율이 없으면 `열 2/3`. */
 declare function columnLabel(place: ColumnPlace): string;
 
-export { BaseFileGenerator, type BaseFileOptions, type BasePropertyOption, type BasePropertySchema, type BaseStatusGroup, type BaseSyncOptions, type BasesFilterNode, type BasesViewMapping, type BasesViewType, BlankLineCollapser, type BookmarkTarget, CONFIG_FILE, CONFLICT_STRATEGIES, type CalendarEntry, type CalloutDesign, CalloutRestorer, CalloutTransformer, ChangeDetector, type ChangeDiff, ColorAnnotator, type ColumnPlace, type CompletenessFailure, type CompletenessLocalSource, type CompletenessOptions, type CompletenessRemoteSource, type CompletenessReport, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, ConnectionBoundaryError, ConnectionScopeError, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DB_VIEWS_FILE, DB_VIEWS_PATH, DEFAULT_CONFIG, DEFAULT_TITLE_PROPERTY, DEFAULT_WATCH_DEBOUNCE_MS, DIFF_SIGN, type DatabaseCompleteness, type DatabaseMove, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, type DeferredCode, type DegradeNote, type DesignColor, type DesignLine, type DesignSegment, type DiffHunk, type DiffLine, EmbedResolver, EntryEditor, type FailedOperation, type FidelityClassification, type FidelityContext, type FidelityDefect, type FidelityDefectForm, type FidelitySummary, type FileDownloadResult, FileHandler, type FileInfo, type FileRegistryEntry, type FileStatInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, type FilterCondition, FilteredVaultFS, type FolderDatabaseReport, type FolderMoveChange, FrontmatterExtractor, FrontmatterGenerator, type FullScanReason, GITIGNORE_ENTRY, type GatedOperation, type GroupByConfig, type GroupedEntries, IGNORE_FILE, INTERNAL_DIR, INTERNAL_DIR_GLOB, type IStateDB, type ImageDownloadResult, ImageHandler, type ImageReference, type InferredProperty, InlineAnnotationPreserver, InlineDBParser, type InlineStyle, type LineDiffOptions, type LineRange, type LocalChange, LocalImageRestorer, type LocalMoveAdoption, type LocalScan, type LocalScanOptions, type Logger, MARKER_BRAND, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NOTION_COLOR_NAMES, NOTION_TOKEN_PREFIX, NOTION_TO_BASES_VIEW, type NestedFolderPage, type NestedFolderRecord, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type NotionSidecar, OBSIDIAN_CONFIG_DIR, type OperationType, type OutsideVault, type PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, PathFilter, type PathFilterConfig, type PendingOperation, PendingWalError, type PlacementChange, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertyRename, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type ReadOnlySkip, type RecordPendingInput, type RegisterFileInput, type RemoteChange, type RemoteMove, type RemoteMoveSkip, type RemoteObservation, type RemoteScanInfo, type RenameHints, type RenameKind, type RenderFinding, type RenderLineRule, type ResolutionChoice, type ResolutionResult, type RichTextSegment, type RowProgress, SAVED_STATE_TABLES_QUERY, SEPARATOR_BODY, STATE_DB_FILE, STATE_DB_MIGRATIONS, STATE_DB_PATH, SavedStateDbError, type SchemaEdit, type SchemaFollowed, ScopedVaultFS, SidecarGenerator, type SidecarProperty, type SidecarView, StateDB, StateDbLockedError, type StateDbMigration, type StateDbTool, StateDbUnavailableError, StateLock, type StateLockClaim, type StateLockOwner, type StatusOptions, type StatusResult, type StyledRange, SyncBusyError, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, type TableLineDesign, type TranslationResult, TreeMapper, UnlinkedVaultError, UnsupportedBlockStripper, type UpsertSyncRecord, type UserBaseFilterFix, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, type ViewEdit, type ViewPropertyConfig, type ViewRenderData, type ViewType, WIKILINK_LOOKUPS, type WatchSyncOptions, type WatchSyncScope, WatchSyncService, type WikilinkEntry, type WikilinkLookup, WikilinkResolver, applicableChoices, assertNoPendingWal, basesViewMappingOf, basesViewTypeOf, choiceForStrategy, classifyBodyFidelity, columnLabel, compactNotionId, computeBufferHash, computeHash, configDirFrom, connectionFolderOf, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, findConnectionFolders, findNestedFolderPages, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasColumnLayout, hasDesignMarker, inAnyPathScope, isHeadingLine, isHeadingMarkerLine, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, normalizeVaultPath, noteNameFromPath, notionIdFromInput, notionIdsEqual, operationLabel, parseDesignColor, parseIgnorePatterns, pendingWalBytes, readColumnLayout, readDesignLine, resolvePropertyName, sanitizeFileName, sectionLinesWithHeadingMarkers, setLogger, shortNotionId, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, toVaultPath, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };
+export { BaseFileGenerator, type BaseFileOptions, type BasePropertyOption, type BasePropertySchema, type BaseStatusGroup, type BaseSyncOptions, type BasesFilterNode, type BasesViewMapping, type BasesViewType, BlankLineCollapser, type BookmarkTarget, CONFIG_FILE, CONFLICT_STRATEGIES, type CalendarEntry, type CalloutDesign, CalloutRestorer, CalloutTransformer, ChangeDetector, type ChangeDiff, ColorAnnotator, type ColumnPlace, type CompletenessFailure, type CompletenessLocalSource, type CompletenessOptions, type CompletenessRemoteSource, type CompletenessReport, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, ConnectionBoundaryError, ConnectionScopeError, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DB_VIEWS_FILE, DB_VIEWS_PATH, DEFAULT_CONFIG, DEFAULT_TITLE_PROPERTY, DEFAULT_WATCH_DEBOUNCE_MS, DIFF_SIGN, type DatabaseCompleteness, type DatabaseMove, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, type DeferredCode, type DegradeNote, type DesignColor, type DesignLine, type DesignSegment, type DiffHunk, type DiffLine, EmbedResolver, EntryEditor, type FailedOperation, type FidelityClassification, type FidelityContext, type FidelityDefect, type FidelityDefectForm, type FidelitySummary, type FileDownloadResult, FileHandler, type FileInfo, type FileRegistryEntry, type FileStatInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, type FilterCondition, FilteredVaultFS, type FolderDatabaseReport, type FolderMoveChange, FrontmatterExtractor, FrontmatterGenerator, type FullScanReason, GITIGNORE_ENTRY, type GatedOperation, type GroupByConfig, type GroupedEntries, IGNORE_FILE, INTERNAL_DIR, INTERNAL_DIR_GLOB, type IStateDB, type ImageDownloadResult, ImageHandler, type ImageReference, type InferredProperty, InlineAnnotationPreserver, InlineDBParser, type InlineStyle, type LineDiffOptions, type LineRange, type LocalChange, LocalImageRestorer, type LocalMoveAdoption, type LocalScan, type LocalScanOptions, type Logger, type Lookbehind, LookbehindRegExp, MARKER_BRAND, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NOTION_COLOR_NAMES, NOTION_TOKEN_PREFIX, NOTION_TO_BASES_VIEW, type NestedFolderPage, type NestedFolderRecord, NodeVaultFS, type NonMdFileInfo, type NotionAccessCheck, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type NotionSidecar, OBSIDIAN_CONFIG_DIR, OBSIDIAN_ONLY_PATTERNS, type OperationType, type OutsideVault, type PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, PathFilter, type PathFilterConfig, type PendingOperation, PendingWalError, type PlacementChange, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertyRename, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type ReadOnlySkip, type RecordPendingInput, type RegisterFileInput, type RemoteChange, type RemoteMove, type RemoteMoveSkip, type RemoteObservation, type RemoteScanInfo, type RenameHints, type RenameKind, type RenderFinding, type RenderLineRule, type ResolutionChoice, type ResolutionResult, type RichTextSegment, type RowProgress, SAVED_STATE_TABLES_QUERY, SEPARATOR_BODY, SIDECAR_SUFFIX, STATE_DB_FILE, STATE_DB_MIGRATIONS, STATE_DB_PATH, SavedStateDbError, type SchemaEdit, type SchemaFollowed, ScopedVaultFS, SidecarGenerator, type SidecarProperty, type SidecarView, StateDB, StateDbLockedError, type StateDbMigration, type StateDbTool, StateDbUnavailableError, StateLock, type StateLockClaim, type StateLockOwner, type StatusOptions, type StatusResult, type StyledRange, SyncBusyError, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, TEMPLATE_FOLDER_SETTINGS, type TableLineDesign, type TranslationResult, TreeMapper, UnlinkedVaultError, UnsupportedBlockStripper, type UpsertSyncRecord, type UserBaseFilterFix, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, type ViewEdit, type ViewPropertyConfig, type ViewRenderData, type ViewType, WIKILINK_LOOKUPS, type WatchSyncOptions, type WatchSyncScope, WatchSyncService, type WikilinkEntry, type WikilinkLookup, WikilinkResolver, applicableChoices, assertNoPendingWal, basesViewMappingOf, basesViewTypeOf, charBefore, checkNotionAccess, choiceForStrategy, classifyBodyFidelity, columnLabel, compactNotionId, computeBufferHash, computeHash, configDirFrom, connectionFolderOf, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, findConnectionFolders, findNestedFolderPages, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasColumnLayout, hasDesignMarker, inAnyPathScope, isHeadingLine, isHeadingMarkerLine, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, normalizeVaultPath, notAfter, noteNameFromPath, notionIdFromInput, notionIdsEqual, notionPageUrl, obsidianOnlyExcludes, operationLabel, parseDesignColor, parseIgnorePatterns, pendingWalBytes, readColumnLayout, readDesignLine, resolvePropertyName, sanitizeFileName, sectionLinesWithHeadingMarkers, setLogger, shortNotionId, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, templateFolders, threeWayMerge, toVaultPath, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };