@im-nobsidian/core 0.4.1 → 0.9.1

package/dist/index.d.ts

@@ -88,7 +88,10 @@ declare const ConfigSchema: z.ZodObject<{
         fullReconcileInterval: z.ZodDefault<z.ZodNumber>;
         deleteSync: z.ZodDefault<z.ZodBoolean>;
         syncFiles: z.ZodDefault<z.ZodBoolean>;
+        createDatabases: z.ZodDefault<z.ZodBoolean>;
+        notifications: z.ZodDefault<z.ZodEnum<["silent", "default"]>>;
     }, "strip", z.ZodTypeAny, {
+        notifications: "silent" | "default";
         direction: "push" | "both" | "pull";
         conflictStrategy: "manual" | "local-first" | "remote-first" | "duplicate";
         autoSync: boolean;
@@ -96,7 +99,9 @@ declare const ConfigSchema: z.ZodObject<{
         fullReconcileInterval: number;
         deleteSync: boolean;
         syncFiles: boolean;
+        createDatabases: boolean;
     }, {
+        notifications?: "silent" | "default" | undefined;
         direction?: "push" | "both" | "pull" | undefined;
         conflictStrategy?: "manual" | "local-first" | "remote-first" | "duplicate" | undefined;
         autoSync?: boolean | undefined;
@@ -104,6 +109,7 @@ declare const ConfigSchema: z.ZodObject<{
         fullReconcileInterval?: number | undefined;
         deleteSync?: boolean | undefined;
         syncFiles?: boolean | undefined;
+        createDatabases?: boolean | undefined;
     }>;
     paths: z.ZodObject<{
         include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -209,6 +215,7 @@ declare const ConfigSchema: z.ZodObject<{
         workspaceId?: string | undefined;
     };
     sync: {
+        notifications: "silent" | "default";
         direction: "push" | "both" | "pull";
         conflictStrategy: "manual" | "local-first" | "remote-first" | "duplicate";
         autoSync: boolean;
@@ -216,6 +223,7 @@ declare const ConfigSchema: z.ZodObject<{
         fullReconcileInterval: number;
         deleteSync: boolean;
         syncFiles: boolean;
+        createDatabases: boolean;
     };
     paths: {
         attachments: string;
@@ -265,6 +273,7 @@ declare const ConfigSchema: z.ZodObject<{
         }[] | undefined;
     };
     sync: {
+        notifications?: "silent" | "default" | undefined;
         direction?: "push" | "both" | "pull" | undefined;
         conflictStrategy?: "manual" | "local-first" | "remote-first" | "duplicate" | undefined;
         autoSync?: boolean | undefined;
@@ -272,6 +281,7 @@ declare const ConfigSchema: z.ZodObject<{
         fullReconcileInterval?: number | undefined;
         deleteSync?: boolean | undefined;
         syncFiles?: boolean | undefined;
+        createDatabases?: boolean | undefined;
     };
     paths: {
         attachments?: string | undefined;
@@ -437,6 +447,8 @@ interface PullOptions extends BaseSyncOptions {
 }
 type SyncOptions = BaseSyncOptions;
 interface PushResult {
+    /** 사이드카로 만든(dry-run 은 만들) Notion DB 수(ADR-036). 없으면 0. */
+    readonly createdDatabases?: number;
     readonly created: number;
     readonly updated: number;
     readonly deleted: number;
@@ -695,6 +707,22 @@ interface ViewConfig {
     readonly datePropertyId?: string;
     readonly datePropertyName?: string;
     readonly viewRange?: "week" | "month";
+    /**
+     * 보기 설정 원본(`views.retrieve` 의 `configuration`) — push 가 새 DB 에 같은 보기를 만들 때 속성 id 만
+     * 바꿔 그대로 보낸다(ADR-036). 위의 낱낱 항목은 `.base` 와 격하 보고가 읽는다.
+     */
+    readonly configuration?: Readonly<Record<string, unknown>>;
+    /** 빠른 필터 — 속성 id → 조건. */
+    readonly quickFilters?: Readonly<Record<string, unknown>>;
+}
+/** `views.create` 에 보낼 보기 — `database_id` · `data_source_id` 는 보내는 쪽이 붙인다. */
+interface ViewRequest {
+    readonly name: string;
+    readonly type: string;
+    readonly filter?: unknown;
+    readonly sorts?: unknown[];
+    readonly quick_filters?: Record<string, unknown>;
+    readonly configuration?: Record<string, unknown>;
 }
 interface DatabaseViewsConfig {
     readonly databaseId: string;
@@ -732,6 +760,8 @@ interface BasePropertySchema {
     readonly type: string;
     readonly options?: BasePropertyOption[];
     readonly groups?: BaseStatusGroup[];
+    /** 이 속성을 다시 만드는 데 드는 타입별 설정(`view/property-definition.ts`) — 사이드카가 적는다. */
+    readonly definition?: Readonly<Record<string, unknown>>;
 }
 interface PageCover {
     readonly type: "file" | "external";
@@ -739,7 +769,7 @@ interface PageCover {
     readonly expiryTime?: string;
 }
 interface PageIcon {
-    readonly type: "emoji" | "external" | "file" | "icon";
+    readonly type: "emoji" | "external" | "file" | "icon" | "custom_emoji";
     readonly value: string;
     readonly color?: string;
 }
@@ -782,6 +812,8 @@ interface IStateDB {
     updatePath(id: string, newPath: string): void;
     delete(id: string): void;
     resolveWikilink(text: string): WikilinkEntry | null;
+    /** relation 값의 위키링크 — 대상 DB(`parentIds`)의 행 가운데서만 찾는다(`wikilinkLookupsIn`). */
+    resolveWikilinkIn(text: string, parentIds: readonly string[]): WikilinkEntry | null;
     resolvePageId(pageId: string): WikilinkEntry | null;
     upsertWikilink(entry: WikilinkEntry): void;
     /** 레코드 삭제 시 해당 경로의 wikilink 항목을 제거한다 (stale 링크 방지). */
@@ -833,6 +865,7 @@ declare class StateDB implements IStateDB {
     updatePath(id: string, newPath: string): void;
     delete(id: string): void;
     resolveWikilink(text: string): WikilinkEntry | null;
+    resolveWikilinkIn(text: string, parentIds: readonly string[]): WikilinkEntry | null;
     resolvePageId(pageId: string): WikilinkEntry | null;
     upsertWikilink(entry: WikilinkEntry): void;
     deleteWikilink(obsidianPath: string): void;
@@ -979,6 +1012,15 @@ interface WikilinkLookup {
     readonly params: (text: string) => string[];
 }
 declare const WIKILINK_LOOKUPS: readonly WikilinkLookup[];
+/**
+ * relation 값의 위키링크 → 대상 DB(`parentIds` — DB id · data source id)의 행만 보는 조회들.
+ *
+ * - 대상 DB 밖 페이지는 고르지 않는다. Notion 은 relation 에 다른 DB 의 페이지를 넣으면 오류 없이 빼 버린다
+ *   (2026-10-23 실측: 200 응답 · 값만 빠짐) — 제목이 같은 다른 DB 의 행으로 풀리면 relation 이 조용히 사라졌다.
+ * - 파일 이름 → 제목 → 별칭 차례. pull 은 relation 값을 파일 이름으로 적는다. 제목을 먼저 보면 제목이 같은
+ *   두 행(한쪽 파일 이름에 `(id)` 가 붙은) 가운데 엉뚱한 행을 걸었다.
+ */
+declare function wikilinkLookupsIn(parentIds: readonly string[]): WikilinkLookup[];
 
 /** 상태 DB 파일 옆의 잠금 파일. */
 declare function stateDbLockPath(dbPath: string): string;
@@ -1067,11 +1109,22 @@ declare function pendingWalBytes(dbPath: string): number;
  */
 declare function assertNoPendingWal(dbPath: string): void;
 
+/** DB 속성 스키마 한 칸 — {@link NotionClient.getDatabaseSchema} 가 내는 꼴. */
+interface DatabasePropertySchema {
+    readonly id: string;
+    readonly type: string;
+    /** relation 이 가리키는 DB — DB id · data source id. */
+    readonly relationTargets?: readonly string[];
+}
 type NotionPropertyValue = Record<string, unknown>;
 interface WikilinkResolver$1 {
     resolve(title: string): string | null;
+    /** 대상 DB(`parentIds`)의 행 가운데서만 — relation 값. 없으면 {@link resolve} 로 찾는다. */
+    resolveIn?(title: string, parentIds: readonly string[]): string | null;
     resolvePageId(pageId: string): string | null;
 }
+/** 이름으로 적힌 사람의 사용자 id — 워크스페이스에 없거나 같은 이름이 여럿이면 null. */
+type PeopleResolver = (name: string) => string | null;
 interface PropertyMapperOptions {
     /**
      * 날짜시각을 적고 보낼 시간대(IANA 이름, 설정 `conversion.timeZone`). 없으면 이 컴퓨터의 시간대.
@@ -1090,19 +1143,31 @@ interface PropertyChangeContext {
      * ({@link patchRichText}). 없으면 평문으로 보낸다.
      */
     readonly remote?: Readonly<Record<string, unknown>>;
+    /**
+     * 파일 속성의 볼트 첨부(`[[attachments/…]]` 의 경로)를 올린 것 — 있으면 그 첨부를 올린 파일로 보낸다
+     * ({@link PropertyMapper.localFileTargets}). 없는 첨부가 섞인 값은 보내지 않는다.
+     */
+    readonly uploads?: ReadonlyMap<string, UploadedFile>;
+}
+/** Notion 에 올린 볼트 파일 — 파일 속성 값으로 보낸다. */
+interface UploadedFile {
+    readonly fileUploadId: string;
+    /** Notion 에 보일 이름 — 받을 때 붙인 내용 해시를 뗀 것. */
+    readonly name: string;
 }
 declare class PropertyMapper {
     private readonly options;
     private schema;
     private wikilinkResolver;
+    private peopleResolver;
     constructor(options?: PropertyMapperOptions);
     /** 설정의 변환 옵션으로 만든다 — 시간대를 이 한 곳에서 읽는다. */
     static fromConfig(config: Pick<Config, "conversion">): PropertyMapper;
     setWikilinkResolver(resolver: WikilinkResolver$1): void;
-    loadSchema(properties: Record<string, {
-        id: string;
-        type: string;
-    }>): void;
+    setPeopleResolver(resolver: PeopleResolver): void;
+    /** 스키마에 사람 속성이 있는가 — 있을 때만 사용자 목록을 읽는다. */
+    hasPeopleProperty(): boolean;
+    loadSchema(properties: Record<string, DatabasePropertySchema>): void;
     /**
      * frontmatter 전체를 Notion 속성 값으로 바꾼다 — 비교할 기준이 없는 새 행을 만들 때 쓴다.
      *
@@ -1129,6 +1194,27 @@ declare class PropertyMapper {
         properties: Record<string, NotionPropertyValue>;
         skipped: string[];
     };
+    /** Notion 이 값을 정하는 속성(수식 · 롤업 · ID · 생성일 …)이 스키마에 있는가 — 버튼은 값이 없다. */
+    hasComputedProperties(): boolean;
+    /**
+     * 바뀐 값 가운데 파일 속성이 가리키는 볼트 첨부의 경로 — 호출측이 올려 {@link PropertyChangeContext.uploads} 로 준다.
+     *
+     * pull 은 Notion 에 올라간 파일을 받아 `[[attachments/…]]` 로 적는다. 그 값을 새 행이나 바뀐 값으로 보낼 때
+     * 첨부를 다시 올리지 않으면 보낼 수가 없다 — 다른 페이지로 옮겨 올린 행의 파일 속성이 비었다(2026-10-23 E2E 9건).
+     */
+    localFileTargets(changed: Readonly<Record<string, unknown>>): string[];
+    /** relation 값(위키링크 · 페이지 id 목록)이 가리키는 페이지 가운데 알아본 것. */
+    relationTargets(value: unknown): string[];
+    /**
+     * @param targets relation 이 가리키는 DB. 알면 그 DB 의 행으로만 푼다 — 다른 DB 의 페이지는 Notion 이 오류
+     *   없이 빼 버리므로, 못 찾은 것으로 두어 보내지 않고 알린다.
+     */
+    private relationTargetOf;
+    /**
+     * 이 속성들 가운데 relation. 보내지 못한 relation 은 대상 노트가 아직 Notion 에 없었을 수 있다 —
+     * 호출측이 기준에서 빼 두고 다시 보낸다.
+     */
+    relationKeys(keys: readonly string[]): string[];
     /**
      * 값을 보낼 수 있는 속성만, pull 이 적는 모양으로 — 원격 값과 로컬 값을 견줄 때 쓴다.
      *
@@ -1178,6 +1264,15 @@ declare class PropertyMapper {
     private extractValue;
 }
 
+/**
+ * 동기화가 쓴 페이지가 사람에게 알림을 보내나(2026-10-08 changelog «Control notifications from page writes»).
+ *
+ * - `silent` — 페이지 수정 · @멘션 · 사람 속성 알림을 보내지 않는다. DB 자동화 · 리마인더 · 웹훅은 그대로다
+ * - `default` — Notion 이 정한 대로 보낸다
+ */
+declare const NOTIFICATION_MODES: readonly ["silent", "default"];
+type NotificationMode = (typeof NOTIFICATION_MODES)[number];
+
 /**
  * 취소 신호. `AbortSignal` 과 호환되며, 테스트에서 가벼운 목 객체로도 쓸 수 있다.
  */
@@ -1243,6 +1338,18 @@ interface DatabaseMeta {
      * source 가 없으면 DB 객체의 속성.
      */
     readonly properties: Readonly<Record<string, unknown>>;
+    /** 페이지 본문 안에 놓인 인라인 DB 인가. */
+    readonly isInline: boolean;
+    /** DB 의 아이콘 · 커버 · 설명 · 제목 표시 — 받은 그대로. */
+    readonly appearance?: DatabaseAppearance;
+}
+/** DB 자체의 꾸밈 — 행이 아니라 DB 의 것이다. 값은 Notion 이 준 그대로(`icon` · `cover` 는 페이지와 같은 꼴). */
+interface DatabaseAppearance {
+    readonly icon: unknown;
+    readonly cover: unknown;
+    readonly description: readonly unknown[];
+    /** 보기 위에 DB 제목을 보이나(2026-10-20 changelog). */
+    readonly showTitle: boolean;
 }
 interface NotionClientOptions {
     readonly token: string;
@@ -1258,6 +1365,8 @@ interface NotionClientOptions {
     readonly markdownCompletionMaxBlocks?: number;
     /** 페이지 속성의 날짜시각을 적을 시간대(`conversion.timeZone`) — 없으면 이 컴퓨터의 시간대. */
     readonly timeZone?: string;
+    /** 쓰기가 알림을 보내나(`sync.notifications`). */
+    readonly notifications?: NotificationMode;
     readonly fetch?: typeof globalThis.fetch;
 }
 declare class NotionClient {
@@ -1275,6 +1384,13 @@ declare class NotionClient {
     private botUserId;
     /** {@link getUserNames} 가 물은 사용자 이름 — 읽지 못한 사용자는 null. */
     private readonly userNames;
+    /**
+     * {@link getDatabaseSyncability} 가 읽은 DB — 바로 뒤 {@link getDatabaseMeta} 가 한 번 쓰고 버린다.
+     * 발견한 DB 는 곧장 행을 받으므로 같은 두 요청(DB · data source)을 되풀이하지 않는다.
+     */
+    private readonly checkedDatabases;
+    /** 보낸 요청 수(재시도는 세지 않는다) — 순회 예산을 잰다. */
+    private requestsSent;
     constructor(options: NotionClientOptions);
     /** config.advanced 의 운영 튜닝값으로 클라이언트를 생성한다 (매직넘버 단일 진실원). */
     static fromConfig(config: Config, fetch?: typeof globalThis.fetch): NotionClient;
@@ -1294,6 +1410,11 @@ declare class NotionClient {
      * 자체는 id 로 보존된다.
      */
     getUserNames(ids: readonly string[]): Promise<Map<string, string>>;
+    /** 워크스페이스 사용자 전부(사람 · 봇) — 손님은 API 가 돌려주지 않는다. */
+    listUsers(): Promise<Array<{
+        id: string;
+        name?: string | null;
+    }>>;
     getPage(pageId: string): Promise<PageObjectResponse>;
     createPage(params: {
         parentId: string;
@@ -1302,6 +1423,33 @@ declare class NotionClient {
         properties?: Record<string, unknown>;
         children?: BlockObjectResponse[];
     }): Promise<PageObjectResponse>;
+    /**
+     * 페이지 아래에 DB 를 만든다(ADR-036). 같은 요청이 두 번 적용되면 DB 가 둘이 된다 — 다시 보내지 않는다.
+     * 부른 쪽이 만들기 전에 자리를 적어 두고, 응답을 잃으면 다음 push 가 부모에서 찾는다.
+     *
+     * @returns 만든 DB 와 그 data source(DB 를 만들면 하나 생긴다)
+     */
+    createDatabase(params: {
+        parentPageId: string;
+        title: string;
+        isInline: boolean;
+        properties: Record<string, unknown>;
+        /** 아이콘 · 커버 · 설명 · 제목 표시 — 요청 꼴 그대로(`databases.create` 의 같은 이름 칸). */
+        appearance?: Readonly<Record<string, unknown>>;
+    }): Promise<{
+        databaseId: string;
+        dataSourceId: string;
+    }>;
+    /** DB 의 첫 data source — 행 · 스키마가 사는 곳. 없으면 null. */
+    primaryDataSourceId(databaseId: string): Promise<string | null>;
+    /**
+     * data source 에 속성을 더하거나 바꾼다. 같은 이름이면 그 속성을 바꾼다 — 다시 보내도 결과가 같다.
+     *
+     * @returns 바꾼 뒤의 속성 전체(이름 → 정의)
+     */
+    updateDataSourceProperties(dataSourceId: string, properties: Record<string, unknown>): Promise<Record<string, Record<string, unknown>>>;
+    /** data source 의 속성(이름 → 정의). */
+    getDataSourceProperties(dataSourceId: string): Promise<Record<string, Record<string, unknown>>>;
     createPageWithMarkdown(params: {
         parentId: string;
         parentType: "page" | "database";
@@ -1320,6 +1468,16 @@ declare class NotionClient {
      */
     restoreLeadingHeading(pageId: string, markdown: string): Promise<boolean>;
     updatePageProperties(pageId: string, properties: Record<string, unknown>): Promise<PageObjectResponse>;
+    /**
+     * 페이지의 아이콘 · 커버만 바꾼다 — `null` 은 지운다. 값은 `notion/decoration-values.ts` 가 만든 객체다.
+     * 모르는 아이콘 이름 · 색이면 Notion 이 `validation_error` 로 거절하고 아무것도 바꾸지 않는다.
+     */
+    updatePageDecorations(pageId: string, decorations: {
+        readonly icon?: unknown;
+        readonly cover?: unknown;
+    }): Promise<PageObjectResponse>;
+    /** 워크스페이스 사용자 이모지의 id — 이름이 꼭 같은 것. 없으면 null. */
+    findCustomEmojiId(name: string): Promise<string | null>;
     /**
      * 페이지 마크다운. 블록이 많아 잘린 부분은 블록 ID 로 다시 받아 채운다(S-06 —
      * {@link completeTruncatedMarkdown}). 돌려준 `unknown_block_ids` 는 권한이 닿지 않아 끝내
@@ -1362,6 +1520,8 @@ declare class NotionClient {
      * SDK(`databases.retrieve`/`dataSources.retrieve`)는 동일 토큰으로 정상 동작한다.
      */
     getDatabaseMeta(databaseId: string): Promise<DatabaseMeta>;
+    /** DB 와 그 data source 들을 읽는다 — `owners` 는 data source 마다 그 부모 DB(읽지 못했으면 undefined). */
+    private readDatabase;
     /** `from` 이 이 DB 를 받은 것이면 그것을, 아니면 새로 받는다. */
     private metaOf;
     /** @param from 이미 받은 이 DB — 주면 다시 받지 않는다. */
@@ -1395,10 +1555,7 @@ declare class NotionClient {
         viewName: string;
     } | null>;
     /** @param from 이미 받은 이 DB — 주면 다시 받지 않는다. */
-    getDatabaseSchema(databaseId: string, from?: DatabaseMeta): Promise<Record<string, {
-        id: string;
-        type: string;
-    }>>;
+    getDatabaseSchema(databaseId: string, from?: DatabaseMeta): Promise<Record<string, DatabasePropertySchema>>;
     /**
      * DB 속성 스키마 전체(선택지·status 그룹 포함).
      *
@@ -1412,6 +1569,14 @@ declare class NotionClient {
     getDatabaseSchemaFull(databaseId: string, from?: DatabaseMeta): Promise<Record<string, BasePropertySchema>>;
     /** 특정 data source 1개를 직접 쿼리한다(저수준). 다중 data source 순회의 빌딩블록. */
     private queryDataSource;
+    /**
+     * data source 하나의 행을 모두 읽는다. 조회 하나는 결과 10,000건에서 멈추고 `request_status.incomplete` 를
+     * 단다(API 2026-04-20) — 그러면 만든 시각 차례로 처음부터 다시 읽되, 한도에 걸릴 때마다 마지막 행의 만든 시각부터
+     * 새 조회를 연다(SDK `iterateAllDataSourceRows` 와 같은 방법 — 그 도우미는 속도 제한을 거치지 않는다).
+     * 한도 밑이면 예전처럼 정렬 없이 한 번 읽는다 — 행 차례(같은 제목의 파일 이름)가 그대로다.
+     */
+    private queryAllRowsOf;
+    private queryRowsByCreatedTime;
     /**
      * database 의 1차 data source 1페이지를 쿼리한다(증분 detect 등 단일 소스 경로용).
      * 전 행을 빠짐없이 받으려면 {@link queryAllDatabasePages} 를 쓴다(전 data source 순회).
@@ -1549,7 +1714,7 @@ declare class NotionClient {
      * root 서브트리를 직접 BFS 순회해 하위 페이지를 모두 수집한다(중첩 깊이 무관·무손실).
      * 비용은 서브트리 전체 블록 수에 비례한다.
      *
-     * @param opts.deadlineMs `Date.now()` 기준 마감 시각. 각 페이지 처리 전 초과를 검사해
+     * @param opts.maxRequests 이 순회가 쓸 요청 수. 각 페이지 처리 전 초과를 검사해
      *   초과 시 {@link DiscoveryTooLargeError}를 던진다(대규모 서브트리 → search 폴백 유도).
      *   **그때까지 찾은 페이지는 에러의 `partial` 에 실어 보낸다** — 버리면 호출측이 두
      *   경로를 경합시키게 되고, 어느 쪽이 이기는지를 벽시계가 정하게 된다(R12-A).
@@ -1557,7 +1722,7 @@ declare class NotionClient {
      * @param opts.signal 취소되면 다음 페이지로 가기 전에 `OperationAbortedError` 로 멈춘다.
      */
     getChildPagesRecursive(parentId: string, opts?: {
-        deadlineMs?: number;
+        maxRequests?: number;
         signal?: AbortLike;
     }): Promise<PageObjectResponse[]>;
     /** 워크스페이스에서 통합에 공유된 모든 페이지를 bulk search 로 열거한다(100/요청). */
@@ -1578,9 +1743,18 @@ declare class NotionClient {
      */
     getPagesUnderRootViaSearch(rootId: string, signal?: AbortLike): Promise<PageObjectResponse[]>;
     listDatabaseViews(databaseId: string): Promise<ViewConfig[]>;
+    /** DB 에 보기를 만든다. 다시 보내면 같은 보기가 둘 생긴다 — 재시도하지 않는다. @returns 만든 보기 id */
+    createView(params: {
+        databaseId: string;
+        dataSourceId: string;
+        request: ViewRequest;
+    }): Promise<string>;
+    /** 보기를 지운다. DB 의 마지막 보기는 지우지 못한다(400). */
+    deleteView(viewId: string): Promise<void>;
     getView(viewId: string): Promise<ViewConfig | null>;
     getDatabaseViewsConfig(databaseId: string): Promise<DatabaseViewsConfig>;
     extractCover(page: PageObjectResponse): PageCover | null;
+    /** 페이지 아이콘 — `value` 는 frontmatter 에 적는 꼴이다(`notion/decoration-values.ts`). */
     extractIcon(page: PageObjectResponse): PageIcon | null;
     extractTitle(page: PageObjectResponse): string;
     /**
@@ -1935,6 +2109,10 @@ interface VaultFS {
     listMarkdownFileStats(): Promise<FileStatInfo[]>;
     listNonMarkdownFiles(): Promise<NonMdFileInfo[]>;
     getFileStat(path: string): Promise<FileStatInfo | null>;
+    /**
+     * 이 볼트(연결)가 맡은 경로인가 — 볼트 안의 다른 연결 폴더(ADR-038)는 false. 없으면 전부 맡는다.
+     */
+    ownsPath?(path: string): boolean;
 }
 
 type ResolutionChoice = "local" | "remote" | "merge" | "duplicate";
@@ -1991,6 +2169,225 @@ declare class ConflictResolver {
     generateDiff(conflict: Conflict): string;
 }
 
+interface BaseFileOptions {
+    readonly databaseId: string;
+    readonly databaseName: string;
+    readonly schema: Record<string, BasePropertySchema>;
+    readonly viewsConfig: DatabaseViewsConfig;
+    readonly folderPath: string;
+    /**
+     * 날짜 속성 이름 → 기간의 끝을 적는 짝 키(`<이름>_end`). 행 노트는 기간을 두 키로 적으므로 표에 그 속성이
+     * 보이면 끝 열도 바로 뒤에 둔다(B13). 받은 행 가운데 기간이 있는 속성만 — 기간을 쓰지 않는 날짜 속성에
+     * 늘 빈 열을 두지 않는다.
+     */
+    readonly rangeEnds?: ReadonlyMap<string, string>;
+}
+type BasesViewType = "table" | "cards" | "list";
+/** Notion 뷰 하나를 Bases 로 옮길 때의 판정. */
+interface BasesViewMapping {
+    /** Bases 뷰 타입. `null` = 대응이 없어 `.base` 에 실을 수 없음. */
+    readonly type: BasesViewType | null;
+    /**
+     * 값이 있으면 **정확한 대응이 아니라 격하**라는 뜻(사람용 사유).
+     * 뷰 자체는 살아남지만 원래 뷰의 표현 일부(달력 격자·타임라인 축)는 재현되지 않는다.
+     */
+    readonly degradeReason?: string;
+}
+/**
+ * Notion 뷰 타입 → Obsidian Bases 뷰 매핑(SSOT).
+ *
+ * 뷰는 현재 pull-authoritative — Notion API 가 2026-03-19 뷰 생성/수정/삭제를 열었지만
+ * 본 프로젝트는 아직 뷰 write-back 을 구현하지 않았다(로드맵 항목). push 로 되돌릴 수
+ * 없는 동안 "조용한 유실 금지"는 곧 "보존 + 정직한 degrade 리포트"를 의미한다.
+ *
+ * 달력·타임라인은 예전에 `null` 이었다 — 즉 `.base` 에서 **통째로 사라졌다**. 사이드카에는
+ * 남지만 Obsidian 을 여는 사람 눈에는 그 뷰가 애초에 없었던 것처럼 보인다. 격자·축은
+ * 못 살려도 "날짜 순으로 늘어놓은 목록"이라는 본래 의도는 표로 남길 수 있으므로,
+ * 버리는 대신 격하해 살리고 사유를 사이드카에 적는다.
+ */
+declare const NOTION_TO_BASES_VIEW: Record<string, BasesViewMapping>;
+/** Notion 뷰 타입의 Bases 매핑. 미상 타입은 표현 불가로 본다. */
+declare function basesViewMappingOf(notionType: string): BasesViewMapping;
+/** Notion 뷰 타입의 Bases 대응 타입을 돌려준다. 미지원/미상 타입은 `null`. */
+declare function basesViewTypeOf(notionType: string): BasesViewType | null;
+declare class BaseFileGenerator {
+    generate(options: BaseFileOptions): string;
+    private writeFilters;
+    private needsContentCoverFormula;
+    private writeFormulas;
+    private writePropertyDisplayNames;
+    private writeViews;
+    /** `filters:` 키와 그 값을 쓴다. 단일 식이면 한 줄, 그룹이면 블록. */
+    private writeFilterValue;
+    /** 필터 노드를 시퀀스 항목(`- …`)으로 쓴다. 그룹이면 재귀적으로 중첩한다. */
+    private writeFilterItem;
+    /**
+     * 필터 식을 YAML 스칼라로 쓴다.
+     *
+     * 식은 대개 `note["상태"] == "진행 중"` 처럼 큰따옴표를 품는다. 평문 스칼라는 큰따옴표를
+     * 안에 담을 수 있으므로(선두만 아니면 된다) 기본은 평문으로 두어 기존 `file.ext == "md"`
+     * 라인과 모양을 맞춘다. 다만 `: `·` #`·선두 지시문자는 평문에서 의미가 달라지므로
+     * 그때만 작은따옴표로 감싼다(속성명에 콜론이나 해시가 들어갈 수 있다).
+     */
+    private yamlExpr;
+    /**
+     * 뷰 이름을 Bases 요구사항대로 유일화한다(in-place). 동명 충돌 시 ' 2',' 3'… 를 붙이되
+     * 이미 존재하는 이름과 다시 충돌하지 않을 때까지 증가시킨다.
+     */
+    private dedupeViewNames;
+    private convertView;
+    private toNoteRef;
+    /**
+     * 속성 참조(order/sort/groupBy/image)를 YAML로 안전하게 출력한다.
+     * `file.name`·`formula.coverImage`·`note.cover` 같은 접두사 식별자와 공백 포함 일반 속성명은
+     * 평문 스칼라로 안전하므로 그대로 두고, 콜론·해시·따옴표 등 YAML 메타문자가 있을 때만 인용한다.
+     */
+    private propRef;
+    private resolvePropertyName;
+    private yamlKey;
+    private yamlValue;
+}
+
+/**
+ * DB 사이드카(`<db>.notion.json`) — `.base` 로 표현할 수 없는 Notion DB 메타데이터를
+ * 무손실 보존하는 단일 파일.
+ *
+ * ## 왜 필요한가 (I4·I7 "조용한 유실 금지")
+ *
+ * Obsidian Bases(`.base`)는 Notion DB 뷰의 일부만 표현한다:
+ *   · 미지원 뷰(calendar/timeline/form/chart/map/dashboard)는 `.base` 에서 통째 누락.
+ *   · 표현되는 뷰도 Notion **필터식·커버 크기/비율·컬럼 width/wrap·빈그룹 숨김** 등은
+ *     Bases 문법에 대응이 없어 손실된다.
+ *
+ * 사이드카는 DB 스키마의 원본이기도 하다(ADR-036, v2) — 새 루트로 올린 DB 폴더를 push 가 이것으로
+ * Notion DB 로 다시 만든다. 그래서 속성마다 다시 만드는 데 드는 설정(`definition`)과 인라인 여부를 적는다.
+ * v1(옵션 이름만)도 읽는다(`sync/database-schema.ts`). `.base` 와 같은 폴더에 두어 사람이 발견할 수 있고
+ * 도구가 다시 쓸 수 있다.
+ *
+ * ## 멱등성
+ *
+ * 매 pull 마다 재생성되므로 **결정적**이어야 한다(타임스탬프·실행시각 금지, 키 정렬).
+ * 동일 DB 상태 → 동일 바이트 → drift 0 / churn 0.
+ */
+/** 이 도구가 쓴 사이드카의 표지 — 읽는 쪽은 이 값으로 사용자가 만든 JSON 과 가린다. */
+declare const SIDECAR_GENERATOR = "im-nobsidian";
+/** 지금 쓰는 사이드카 형식 판. 판이 적히지 않은 옛 파일은 1 로 읽는다. */
+declare const SIDECAR_SCHEMA_VERSION = 2;
+interface NotionSidecar {
+    readonly generator: typeof SIDECAR_GENERATOR;
+    readonly schemaVersion: typeof SIDECAR_SCHEMA_VERSION;
+    readonly databaseId: string;
+    readonly databaseName: string;
+    /** 페이지 본문 안에 놓인 인라인 DB 인가 — 다시 만들 때 같게. */
+    readonly isInline: boolean;
+    /** 속성 스키마 — 이름 정렬. `.base` displayName 만으로는 잃는 타입/옵션을 보존. */
+    readonly properties: SidecarProperty[];
+    /** 모든 뷰(표현/미표현 공통) — Notion 순서 유지. */
+    readonly views: SidecarView[];
+    /** 정직한 손실 리포트 — 무엇이 `.base` 에서 누락/degrade 됐는가. */
+    readonly degraded: DegradeNote[];
+    /** DB 자체의 꾸밈 — 있는 것만. 없으면 키가 없다(꾸밈 없는 DB 의 사이드카는 예전과 같은 바이트). */
+    readonly appearance?: SidecarAppearance;
+}
+/**
+ * DB 의 아이콘 · 커버 · 설명 · 제목 표시. `icon` · `cover` 는 페이지 frontmatter 와 같은 꼴
+ * (`notion/decoration-values.ts`), `description` 은 NFM 한 줄.
+ */
+interface SidecarAppearance {
+    readonly icon?: string;
+    readonly cover?: string;
+    readonly description?: string;
+    /** 보기 위에 DB 제목을 숨겼으면 false. 보이면(기본) 없다. */
+    readonly showTitle?: false;
+}
+interface SidecarProperty {
+    readonly name: string;
+    readonly id: string;
+    readonly type: string;
+    /** select/multi_select/status 옵션명(있으면). */
+    readonly options?: string[];
+    /** 다시 만드는 데 드는 타입별 설정(`view/property-definition.ts`). 타입 이름만으로 되면 없다. */
+    readonly definition?: Readonly<Record<string, unknown>>;
+}
+interface SidecarView {
+    readonly id: string;
+    readonly name: string;
+    readonly notionType: string;
+    /** Bases 대응 타입. `null` = `.base` 미표현(사이드카가 유일 보존처). */
+    readonly basesType: BasesViewType | null;
+    /** 원본 뷰 설정 중 의미 있는 항목(키 정렬). 빈 값은 생략. */
+    readonly config: Record<string, unknown>;
+}
+interface DegradeNote {
+    readonly view: string;
+    /**
+     * `view-unrepresentable` = 뷰가 `.base` 에서 통째로 누락.
+     * `view-degraded` = 뷰는 남지만 다른 타입으로 격하(달력→표 등).
+     * `setting-dropped` = 뷰는 그대로지만 설정 하나가 빠짐.
+     */
+    readonly kind: "view-unrepresentable" | "view-degraded" | "setting-dropped";
+    readonly detail: string;
+}
+declare class SidecarGenerator {
+    /**
+     * 사이드카 객체를 빌드한다(순수 — I/O 없음). 직렬화는 {@link serialize} 가 담당.
+     */
+    build(options: {
+        databaseId: string;
+        databaseName: string;
+        schema: Record<string, BasePropertySchema>;
+        viewsConfig: DatabaseViewsConfig;
+        isInline?: boolean;
+        appearance?: SidecarAppearance;
+    }): NotionSidecar;
+    /**
+     * 사이드카를 결정적 JSON 문자열로 직렬화한다(키 재귀 정렬 + 말미 개행).
+     * 동일 입력 → 동일 바이트 → 멱등(drift/churn 0).
+     */
+    serialize(sidecar: NotionSidecar): string;
+    private buildProperties;
+    private buildView;
+    /**
+     * 뷰 설정 중 의미 있는 항목을 추출한다. `.base` 가 표현 못하는 항목(필터·커버크기 등)은
+     * config 에 보존하면서 동시에 degrade 리포트에 1줄씩 기록한다(표현되는 뷰에 한해 —
+     * 미표현 뷰는 이미 view-unrepresentable 로 통째 보고됨).
+     */
+    private extractConfig;
+    /**
+     * 필터 손실을 **실제로 못 옮긴 것만** 보고한다.
+     *
+     * 예전엔 필터가 있기만 하면 "Notion 필터식은 .base 로 표현되지 않음"을 무조건 찍었다.
+     * 이제 `.base` 가 뷰별 `filters:` 를 내보내므로 그 문구는 대부분의 경우 거짓이다.
+     * 거짓 degrade 는 진짜 degrade 를 묻어 버리므로, `.base` 와 **같은 번역기**를 돌려
+     * 남은 것만 적는다(두 산출물이 어긋날 여지를 없앤다).
+     */
+    private noteFilterDegrade;
+}
+
+/** 속성 하나를 어떻게 정했나. */
+interface InferredProperty {
+    readonly name: string;
+    readonly type: string;
+    /** 사람이 읽는 까닭 — `Obsidian 속성 타입 number` · `값 12개가 모두 날짜` … */
+    readonly reason: string;
+}
+interface FolderDatabaseDraft {
+    readonly sidecar: NotionSidecar;
+    readonly properties: readonly InferredProperty[];
+    /** 옮긴 보기 이름. */
+    readonly views: readonly string[];
+    /** 옮기지 않은 것과 까닭 — 키 · 보기 · 필터. */
+    readonly skipped: ReadonlyArray<{
+        readonly what: string;
+        readonly reason: string;
+    }>;
+}
+interface FolderDatabaseReport extends FolderDatabaseDraft {
+    readonly folder: string;
+    readonly sidecarPath: string;
+    readonly rows: number;
+}
+
 /**
  * 한 오케스트레이터의 작업은 한 번에 하나만 돈다(S-09).
  *
@@ -2005,7 +2402,7 @@ declare class ConflictResolver {
  * 긴 sync(실볼트 pull 500초) 동안 주기 sync 가 쌓인다.
  */
 /** 잠그는 작업 — 볼트 · 상태 DB · 원격을 바꾸거나 이번 실행의 기준을 정하는 것. */
-type GatedOperation = "push" | "pull" | "sync" | "status" | "fetch" | "resolve" | "discard";
+type GatedOperation = "push" | "pull" | "sync" | "status" | "fetch" | "resolve" | "discard" | "prepare-database";
 declare function operationLabel(operation: GatedOperation): string;
 declare class SyncBusyError extends Error {
     /** 이미 도는 작업. */
@@ -2030,6 +2427,7 @@ declare class SyncOrchestrator {
     private readonly rowSchemas;
     private readonly observation;
     private readonly placement;
+    private readonly databaseCreator;
     private readonly planner;
     private readonly detector;
     private readonly drift;
@@ -2045,7 +2443,17 @@ declare class SyncOrchestrator {
     /** 도는 작업 — 없으면 null(S-09). 부른 쪽이 겹칠 요청을 미리 거를 때 쓴다. */
     get runningOperation(): GatedOperation | null;
     push(options?: PushOptions): Promise<PushResult>;
+    /**
+     * 다른 연결 폴더 안의 노트를 추적하고 있으면 아무것도 하지 않고 멈춘다(ADR-038) — 그 노트들은 이 연결의
+     * 목록에 없으므로, 그대로 돌리면 「볼트에서 지움」 으로 보고 Notion 페이지를 지우거나 되살리려 한다.
+     */
+    private assertConnectionScope;
     private executePush;
+    /**
+     * 만든 DB 에 relation · rollup · formula 를 붙이고, 행 스키마를 다시 읽게 한 뒤 보기를 만든다. 실패는
+     * 다음 push 가 이어 붙인다 — 행은 그대로 올린다.
+     */
+    private completeDatabaseSchemas;
     /** 볼트의 노트가 마지막으로 올린 내용 그대로인가 — 읽지 못하면(지움 · 옮김) 아니다. */
     private unchangedSincePush;
     pull(options?: PullOptions): Promise<PullResult>;
@@ -2124,6 +2532,13 @@ declare class SyncOrchestrator {
      * 않는다. 되돌릴 원본이 없는 것은 이유와 함께 거절한다.
      */
     discardLocalChange(path: string): Promise<void>;
+    /**
+     * 볼트에서 만든 노트 폴더를 Notion DB 로 올릴 준비 — frontmatter · `.base` 로 사이드카를 써 둔다(#75).
+     * Notion 에는 쓰지 않는다. 다음 push 가 DB 를 만들고 노트를 행으로 올린다(ADR-036 · ADR-037).
+     *
+     * @param configDir Obsidian 설정 폴더 — 속성 타입(`types.json`)을 읽는다.
+     */
+    prepareFolderDatabase(folder: string, configDir?: string): Promise<FolderDatabaseReport>;
     /** 충돌 미리보기용 줄 비교(로컬 vs 원격). 해소 없이 표시 전용. */
     generateConflictDiff(conflict: Conflict): string;
 }
@@ -2199,6 +2614,8 @@ interface ImageDownloadResult {
     readonly size: number;
     /** 받은 파일의 전체 sha256 — 받은 미디어 기록에 적어 push 가 그 파일이 그대로인지 본다. */
     readonly fileHash?: string;
+    /** 임베드 별칭으로 쓸 이름 — 받은 이름에서 이 볼트가 붙인 내용 해시를 뗀 것({@link withoutOwnHash}). */
+    readonly name?: string;
 }
 interface ImageUploadResult {
     readonly localPath: string;
@@ -2241,6 +2658,7 @@ declare class ImageHandler {
     /** 상한 로직은 첨부 경로와 공유한다 — 한쪽만 빠뜨리지 않도록(utils/download-fetch). */
     private fetchForDownload;
     downloadImage(url: string, pageTitle: string): Promise<ImageDownloadResult>;
+    /** @param uploadedName Notion 에 올라간 파일 이름 — 받은 파일의 이름이 된다({@link imageStemOf}). */
     private fetchImage;
     /**
      * 캡션이 push 가 적어 둔 원본 임베드 대상인지 판정한다(R1). 맞으면 그 문자열을
@@ -2281,6 +2699,12 @@ declare class ImageHandler {
         downloads: ImageDownloadResult[];
     }>;
     uploadLocalImage(localPath: string, noteFolder?: string): Promise<ImageUploadResult>;
+    /**
+     * 노트가 가리키는 볼트 첨부 하나를 올린다 — 파일 속성 값으로 보낼 것.
+     *
+     * @returns 보일 이름은 받을 때 붙인 내용 해시를 뗀 것이다 — 다시 받으면 같은 이름 · 같은 경로가 된다.
+     */
+    uploadNoteAttachment(target: string, notePath: string): Promise<UploadedFile>;
     uploadAndAppendImages(pageId: string, images: ImageReference[], notePath?: string): Promise<ImageUploadResult[]>;
     /**
      * 본문을 보내기 전에, 다시 올리지 않아도 되는 미디어 자리표시자를 Notion 에 이미 있는 그 파일로
@@ -2636,20 +3060,39 @@ declare class DatabaseSyncer {
      * 아무것도 가라앉았다고 보지 않는다 — 수정 시각이 같은 행도 받아서 견준다.
      */
     private readonly observation;
+    /**
+     * 받은 행 본문(Notion 원문)을 알린다 — 감지가 행의 하위 페이지를 빠뜨렸을 때 그 본문의 자식 태그로
+     * 채운다({@link RemoteDetector.noteBodyChildren}).
+     */
+    private readonly noteRowBody;
     private readonly propertyMapper;
+    private decorationsCache?;
+    /**
+     * 받은 DB 마다 사이드카에 적을 꾸밈 — 한 pull 이 같은 DB 의 사이드카를 여러 번 다시 만든다(임베드 재작성).
+     * 올린 파일 아이콘 · 커버를 그때마다 내려받지 않는다.
+     */
+    private readonly appearances;
     private readonly baseFileGenerator;
+    /** 사용자가 만든 `.base` 라 덮어쓰지 않았다고 이미 알린 경로 — 한 pull 이 같은 DB 를 여러 번 다시 쓴다. */
+    private readonly keptUserBases;
     private readonly sidecarGenerator;
     /**
      * 실제로 기록한 .base 경로/DB 제목 — placeholder 임베드 재작성(F22)의 SSOT. 이번 pull 이 조회하지
      * 않은 DB 의 것도 남아 있다({@link DbBaseFiles}).
      */
     readonly baseFileInfo: DbBaseFiles;
+    private get decorations();
     constructor(config: Config, stateDb: IStateDB, notionClient: NotionClient, vaultFs: VaultFS, pipeline: ConversionPipeline, imageHandler: ImageHandler, 
     /**
      * 이번 동기화가 원격을 보는 기준(N-05) — 오케스트레이터가 실행마다 정한다. 따로 쓰면(시험)
      * 아무것도 가라앉았다고 보지 않는다 — 수정 시각이 같은 행도 받아서 견준다.
      */
-    observation?: () => ObservationContext);
+    observation?: () => ObservationContext, 
+    /**
+     * 받은 행 본문(Notion 원문)을 알린다 — 감지가 행의 하위 페이지를 빠뜨렸을 때 그 본문의 자식 태그로
+     * 채운다({@link RemoteDetector.noteBodyChildren}).
+     */
+    noteRowBody?: (pageId: string, rawMarkdown: string) => void);
     pullAll(opts?: {
         readonly paths?: readonly string[];
         readonly progress?: RowProgress;
@@ -2657,6 +3100,8 @@ declare class DatabaseSyncer {
         readonly ledger?: DatabasePullLedger;
         /** 취소하면 다음 DB 를 조회하지 않는다 — 닿지 못한 DB 는 다음 pull 이 조회한다. */
         readonly signal?: AbortLike;
+        /** {@link pullDatabase} 의 같은 이름 옵션. */
+        readonly rescanRowChildren?: boolean;
     }): Promise<DatabaseSyncResult>;
     pullDatabase(dbConfig: DatabaseSyncConfig, opts?: {
         /**
@@ -2672,7 +3117,18 @@ declare class DatabaseSyncer {
         paths?: readonly string[];
         /** 받은 행 · 지운 행을 하나씩 알린다. 예전에는 pull 진행 표시에 행이 하나도 보이지 않았다. */
         progress?: RowProgress;
+        /**
+         * `--force` — 그대로라 받지 않는 행도 본문을 읽어 하위 페이지를 알린다({@link noteRowBody}). 감지가 빠뜨린
+         * 행의 하위 페이지는 행 본문으로만 보이는데, 이미 받은 행은 바뀌기 전까지 본문을 다시 읽지 않는다.
+         * 행 파일은 쓰지 않는다.
+         */
+        rescanRowChildren?: boolean;
     }): Promise<DatabaseSyncResult>;
+    /**
+     * 받지 않는 행의 본문을 읽어 하위 페이지만 알린다(`--force`). 읽지 못한 행은 경고만 남긴다 — 그 행은 받을 것이
+     * 없었고, 하위 페이지는 다음 `--force` 가 다시 찾는다.
+     */
+    private noteUnchangedRowBodies;
     /**
      * 받을 행을 세기만 한다(dry-run) — 볼트 · 상태 DB · Notion 을 바꾸지 않는다. 조회 · 범위 · 받을
      * 행 판정 · 삭제 확인은 {@link pullDatabase} 와 같다.
@@ -2756,10 +3212,24 @@ declare class DatabaseSyncer {
      * 지우지 않고 충돌로 남기거나 파일을 둔다.
      */
     private pullDeletedRows;
+    /**
+     * DB 의 보기를 Notion 에서 다시 읽어 `db-views.json` 에 적는다. DB 를 통째로 받을 때(행이 바뀐 DB · 전체 대조)
+     * 마다 부른다 — 보기만 고친 것은 DB 의 수정 시각을 바꾸지 않아(2026-10-23 실측) 다음 전체 대조가 받는다.
+     * 예전에는 처음 받은 보기를 끝까지 썼다 — Notion 에서 더하거나 고친 보기가 `.base` 에 오지 않았다.
+     * 읽지 못하면 받아 둔 보기를 쓴다 — 보기가 빠진 `.base` 를 쓰지 않는다.
+     */
     private pullDatabaseViews;
     /** 행들 가운데 한 번이라도 기간인 날짜 속성 → 그 짝 키. */
     private rangeEndsOf;
     private generateBaseFile;
+    /**
+     * DB 의 아이콘 · 커버 · 설명 · 제목 표시 — push 가 DB 를 다시 만들 때 쓴다(ADR-036). 아이콘 · 커버는 페이지와
+     * 같은 꼴로 적고 올린 파일은 볼트로 내려받는다 — 서명 주소를 적으면 pull 마다 사이드카가 바뀐다.
+     */
+    private appearanceOf;
+    private readAppearance;
+    /** pull 이 쓰지 않은 `.base` · 사이드카가 이미 있는가 — 없거나 읽지 못하면 false. */
+    private isUserFile;
     /**
      * DB 제목이 바뀌면 `.base`/`.notion.json` 파일명(safeName)이 바뀌어 옛 이름의 산출물이
      * 같은 폴더에 고아로 잔존한다(drift·부활 원인). DB 폴더 **직속**의 산출물 중 현재 이름이
@@ -2808,23 +3278,16 @@ declare class DatabaseSyncer {
         bodyFingerprint: string;
     }>;
     /**
-     * 행의 본문 밖이 지난 동기화 사본 그대로인가(N-05) — 제목과 보낼 수 있는 속성, 그리고
-     * {@link renderRow} 로 받는 행이면 아이콘 · 커버. push 는 원격을 덮어써도 되는지, pull 은 받을
+     * 행의 본문 밖이 지난 동기화 사본 그대로인가(N-05) — 제목과 보낼 수 있는 속성, 아이콘 · 커버.
+     * push 는 원격을 덮어써도 되는지, pull 은 받을
      * 것이 있는지를 이 규칙으로 가른다. 읽기 전용 속성(수식 · 롤업 · 수정 시각)은 보지 않는다 —
      * 로컬에서 고칠 수 없고 push 가 보내지 않는다.
      *
      * @param mapper 그 행의 DB 스키마를 읽은 매퍼.
      * @param base 지난 동기화 시점의 frontmatter.
      * @param path 지난 동기화 시점의 경로 — 파일 이름을 따르던 제목을 가른다.
-     * @param decorated 아이콘 · 커버도 견주나 — {@link renderRow} 로 받는 행만 그것을 노트에 적는다.
-     */
-    rowOutsideBodyUnchanged(mapper: PropertyMapper, page: PageObjectResponse, base: Readonly<Record<string, unknown>>, path: string, decorated: boolean): boolean;
-    /**
-     * 원격 행의 아이콘 · 커버가 `frontmatter` 에 적힌 그대로인가 — {@link renderRow} 가 적는 모양으로
-     * 견준다(N-05). Notion 에 올린 파일은 읽을 때마다 주소가 바뀌고(서명) 커버는 볼트로 내려받아
-     * 적으므로, 있는지만 견준다.
      */
-    private decorationsUnchanged;
+    rowOutsideBodyUnchanged(mapper: PropertyMapper, page: PageObjectResponse, base: Readonly<Record<string, unknown>>, path: string): boolean;
     /** 레코드가 지난번에 본 원격 행과 지금 행을 견준다 — 이번 동기화의 기준으로(N-05). */
     private remoteVerdict;
     /**
@@ -3231,85 +3694,6 @@ declare class EntryEditor {
     updateDate(entryPath: string, dateProperty: string, newDate: string): Promise<void>;
 }
 
-interface BaseFileOptions {
-    readonly databaseId: string;
-    readonly databaseName: string;
-    readonly schema: Record<string, BasePropertySchema>;
-    readonly viewsConfig: DatabaseViewsConfig;
-    readonly folderPath: string;
-    /**
-     * 날짜 속성 이름 → 기간의 끝을 적는 짝 키(`<이름>_end`). 행 노트는 기간을 두 키로 적으므로 표에 그 속성이
-     * 보이면 끝 열도 바로 뒤에 둔다(B13). 받은 행 가운데 기간이 있는 속성만 — 기간을 쓰지 않는 날짜 속성에
-     * 늘 빈 열을 두지 않는다.
-     */
-    readonly rangeEnds?: ReadonlyMap<string, string>;
-}
-type BasesViewType = "table" | "cards" | "list";
-/** Notion 뷰 하나를 Bases 로 옮길 때의 판정. */
-interface BasesViewMapping {
-    /** Bases 뷰 타입. `null` = 대응이 없어 `.base` 에 실을 수 없음. */
-    readonly type: BasesViewType | null;
-    /**
-     * 값이 있으면 **정확한 대응이 아니라 격하**라는 뜻(사람용 사유).
-     * 뷰 자체는 살아남지만 원래 뷰의 표현 일부(달력 격자·타임라인 축)는 재현되지 않는다.
-     */
-    readonly degradeReason?: string;
-}
-/**
- * Notion 뷰 타입 → Obsidian Bases 뷰 매핑(SSOT).
- *
- * 뷰는 현재 pull-authoritative — Notion API 가 2026-03-19 뷰 생성/수정/삭제를 열었지만
- * 본 프로젝트는 아직 뷰 write-back 을 구현하지 않았다(로드맵 항목). push 로 되돌릴 수
- * 없는 동안 "조용한 유실 금지"는 곧 "보존 + 정직한 degrade 리포트"를 의미한다.
- *
- * 달력·타임라인은 예전에 `null` 이었다 — 즉 `.base` 에서 **통째로 사라졌다**. 사이드카에는
- * 남지만 Obsidian 을 여는 사람 눈에는 그 뷰가 애초에 없었던 것처럼 보인다. 격자·축은
- * 못 살려도 "날짜 순으로 늘어놓은 목록"이라는 본래 의도는 표로 남길 수 있으므로,
- * 버리는 대신 격하해 살리고 사유를 사이드카에 적는다.
- */
-declare const NOTION_TO_BASES_VIEW: Record<string, BasesViewMapping>;
-/** Notion 뷰 타입의 Bases 매핑. 미상 타입은 표현 불가로 본다. */
-declare function basesViewMappingOf(notionType: string): BasesViewMapping;
-/** Notion 뷰 타입의 Bases 대응 타입을 돌려준다. 미지원/미상 타입은 `null`. */
-declare function basesViewTypeOf(notionType: string): BasesViewType | null;
-declare class BaseFileGenerator {
-    generate(options: BaseFileOptions): string;
-    private writeFilters;
-    private needsContentCoverFormula;
-    private writeFormulas;
-    private writePropertyDisplayNames;
-    private writeViews;
-    /** `filters:` 키와 그 값을 쓴다. 단일 식이면 한 줄, 그룹이면 블록. */
-    private writeFilterValue;
-    /** 필터 노드를 시퀀스 항목(`- …`)으로 쓴다. 그룹이면 재귀적으로 중첩한다. */
-    private writeFilterItem;
-    /**
-     * 필터 식을 YAML 스칼라로 쓴다.
-     *
-     * 식은 대개 `note["상태"] == "진행 중"` 처럼 큰따옴표를 품는다. 평문 스칼라는 큰따옴표를
-     * 안에 담을 수 있으므로(선두만 아니면 된다) 기본은 평문으로 두어 기존 `file.ext == "md"`
-     * 라인과 모양을 맞춘다. 다만 `: `·` #`·선두 지시문자는 평문에서 의미가 달라지므로
-     * 그때만 작은따옴표로 감싼다(속성명에 콜론이나 해시가 들어갈 수 있다).
-     */
-    private yamlExpr;
-    /**
-     * 뷰 이름을 Bases 요구사항대로 유일화한다(in-place). 동명 충돌 시 ' 2',' 3'… 를 붙이되
-     * 이미 존재하는 이름과 다시 충돌하지 않을 때까지 증가시킨다.
-     */
-    private dedupeViewNames;
-    private convertView;
-    private toNoteRef;
-    /**
-     * 속성 참조(order/sort/groupBy/image)를 YAML로 안전하게 출력한다.
-     * `file.name`·`formula.coverImage`·`note.cover` 같은 접두사 식별자와 공백 포함 일반 속성명은
-     * 평문 스칼라로 안전하므로 그대로 두고, 콜론·해시·따옴표 등 YAML 메타문자가 있을 때만 인용한다.
-     */
-    private propRef;
-    private resolvePropertyName;
-    private yamlKey;
-    private yamlValue;
-}
-
 /**
  * 속성 id → 프론트매터 키 해소.
  *
@@ -3372,99 +3756,6 @@ type PropertyNameResolver = (idOrName: string) => string | undefined;
  */
 declare function translateNotionFilter(filter: unknown, schema: Record<string, BasePropertySchema>, resolveName: PropertyNameResolver): TranslationResult;
 
-/**
- * DB 사이드카(`<db>.notion.json`) — `.base` 로 표현할 수 없는 Notion DB 메타데이터를
- * 무손실 보존하는 단일 파일.
- *
- * ## 왜 필요한가 (I4·I7 "조용한 유실 금지")
- *
- * Obsidian Bases(`.base`)는 Notion DB 뷰의 일부만 표현한다:
- *   · 미지원 뷰(calendar/timeline/form/chart/map/dashboard)는 `.base` 에서 통째 누락.
- *   · 표현되는 뷰도 Notion **필터식·커버 크기/비율·컬럼 width/wrap·빈그룹 숨김** 등은
- *     Bases 문법에 대응이 없어 손실된다.
- *
- * Notion API 는 뷰 생성/수정을 지원하지 않으므로(뷰는 pull-authoritative) 이 메타데이터는
- * push 로 Notion 에 되돌릴 수 없다. 따라서 "무손실"의 의미는 **로컬에 완전·정직하게
- * 보존하고, 무엇이 degrade 됐는지 명시 리포트**하는 것이다. 사이드카는 이를 `.base` 와
- * 같은 폴더에 co-locate 해 사람이 발견 가능하고 도구가 재사용 가능하게 만든다.
- *
- * ## 멱등성
- *
- * 매 pull 마다 재생성되므로 **결정적**이어야 한다(타임스탬프·실행시각 금지, 키 정렬).
- * 동일 DB 상태 → 동일 바이트 → drift 0 / churn 0.
- */
-interface NotionSidecar {
-    readonly generator: "im-nobsidian";
-    readonly schemaVersion: 1;
-    readonly databaseId: string;
-    readonly databaseName: string;
-    /** 속성 스키마 — 이름 정렬. `.base` displayName 만으로는 잃는 타입/옵션을 보존. */
-    readonly properties: SidecarProperty[];
-    /** 모든 뷰(표현/미표현 공통) — Notion 순서 유지. */
-    readonly views: SidecarView[];
-    /** 정직한 손실 리포트 — 무엇이 `.base` 에서 누락/degrade 됐는가. */
-    readonly degraded: DegradeNote[];
-}
-interface SidecarProperty {
-    readonly name: string;
-    readonly id: string;
-    readonly type: string;
-    /** select/multi_select/status 옵션명(있으면). */
-    readonly options?: string[];
-}
-interface SidecarView {
-    readonly id: string;
-    readonly name: string;
-    readonly notionType: string;
-    /** Bases 대응 타입. `null` = `.base` 미표현(사이드카가 유일 보존처). */
-    readonly basesType: BasesViewType | null;
-    /** 원본 뷰 설정 중 의미 있는 항목(키 정렬). 빈 값은 생략. */
-    readonly config: Record<string, unknown>;
-}
-interface DegradeNote {
-    readonly view: string;
-    /**
-     * `view-unrepresentable` = 뷰가 `.base` 에서 통째로 누락.
-     * `view-degraded` = 뷰는 남지만 다른 타입으로 격하(달력→표 등).
-     * `setting-dropped` = 뷰는 그대로지만 설정 하나가 빠짐.
-     */
-    readonly kind: "view-unrepresentable" | "view-degraded" | "setting-dropped";
-    readonly detail: string;
-}
-declare class SidecarGenerator {
-    /**
-     * 사이드카 객체를 빌드한다(순수 — I/O 없음). 직렬화는 {@link serialize} 가 담당.
-     */
-    build(options: {
-        databaseId: string;
-        databaseName: string;
-        schema: Record<string, BasePropertySchema>;
-        viewsConfig: DatabaseViewsConfig;
-    }): NotionSidecar;
-    /**
-     * 사이드카를 결정적 JSON 문자열로 직렬화한다(키 재귀 정렬 + 말미 개행).
-     * 동일 입력 → 동일 바이트 → 멱등(drift/churn 0).
-     */
-    serialize(sidecar: NotionSidecar): string;
-    private buildProperties;
-    private buildView;
-    /**
-     * 뷰 설정 중 의미 있는 항목을 추출한다. `.base` 가 표현 못하는 항목(필터·커버크기 등)은
-     * config 에 보존하면서 동시에 degrade 리포트에 1줄씩 기록한다(표현되는 뷰에 한해 —
-     * 미표현 뷰는 이미 view-unrepresentable 로 통째 보고됨).
-     */
-    private extractConfig;
-    /**
-     * 필터 손실을 **실제로 못 옮긴 것만** 보고한다.
-     *
-     * 예전엔 필터가 있기만 하면 "Notion 필터식은 .base 로 표현되지 않음"을 무조건 찍었다.
-     * 이제 `.base` 가 뷰별 `filters:` 를 내보내므로 그 문구는 대부분의 경우 거짓이다.
-     * 거짓 degrade 는 진짜 degrade 를 묻어 버리므로, `.base` 와 **같은 번역기**를 돌려
-     * 남은 것만 적는다(두 산출물이 어긋날 여지를 없앤다).
-     */
-    private noteFilterDegrade;
-}
-
 declare function sortEntries(entries: DBEntry[], sorts: NonNullable<ViewConfig["sorts"]>): DBEntry[];
 declare function groupEntries(entries: DBEntry[], groupByProperty: string, options?: {
     sort?: "ascending" | "descending";
@@ -3702,6 +3993,84 @@ interface Logger {
 declare function setLogger(logger: Logger): void;
 declare function getLogger(): Logger;
 
+/**
+ * 볼트 하나에 연결 여럿 (ADR-038) — 연결마다 볼트 안의 폴더 하나를 맡는다.
+ *
+ * 연결 폴더는 자기 `.im-nobsidian/`(설정 · 상태 DB · 보기 설정)를 둔다. 엔진은 그 폴더를 볼트처럼 다루고
+ * ({@link ScopedVaultFS}), 바깥 연결은 안쪽 연결 폴더를 읽어 올리지도 쓰지도 않는다. 볼트 맨 위의 연결은
+ * 폴더 `""` 이다 — 예전부터 쓰던 단일 연결이 그대로 그것이다.
+ */
+
+/** 이 연결이 맡지 않은 곳에 쓰려 했다 — 폴더 밖이거나 다른 연결 폴더 안이다. */
+declare class ConnectionBoundaryError extends Error {
+    readonly path: string;
+    readonly folder: string;
+    readonly where: "inside" | "outside";
+    /**
+     * @param folder 막은 연결 폴더 — `inside` 면 안쪽의 다른 연결, `outside` 면 이 연결.
+     */
+    constructor(path: string, folder: string, where: "inside" | "outside");
+}
+/**
+ * 이 연결의 상태 DB 가 다른 연결 폴더 안의 노트를 추적하고 있다 — 이미 동기화하던 폴더를 따로 연결했다.
+ *
+ * 그대로 돌리면 바깥 연결은 그 노트들을 「볼트에서 지움」 으로 보고(목록에 없으므로) Notion 페이지를 지우거나,
+ * 되살리려고 그 폴더에 쓰려 한다. 둘 다 사용자가 바란 것이 아니므로 아무것도 하지 않고 멈춘다.
+ */
+declare class ConnectionScopeError extends Error {
+    readonly paths: readonly string[];
+    constructor(paths: readonly string[]);
+}
+/** 앞뒤 `/` 를 떼고 `.` · `..` 를 푼 POSIX 경로. 볼트 맨 위를 벗어나면 null. */
+declare function normalizeVaultPath(path: string): string | null;
+/** `path` 를 맡은 연결 폴더 — 가장 깊은 것. 어느 것도 아니면 null(`""` 연결이 있으면 그것). */
+declare function connectionFolderOf(path: string, folders: readonly string[]): string | null;
+/** 한 연결 폴더에서 Obsidian 설정 폴더까지의 상대 경로 — `Work/Team` 이면 `../../.obsidian`. */
+declare function configDirFrom(folder: string, configDir: string): string;
+/**
+ * 볼트의 한 연결 폴더를 볼트처럼 보이는 VaultFS. 경로는 그 폴더 기준이다.
+ *
+ * - 목록은 폴더 안 · 안쪽 연결 폴더 밖의 파일만, 이 연결의 내부 폴더(`.im-nobsidian/`)는 빼고 낸다
+ * - 쓰기(쓰기 · 지우기 · 옮기기 · 폴더 만들기)는 폴더를 벗어나거나 안쪽 연결 폴더에 닿으면
+ *   {@link ConnectionBoundaryError} 로 거절한다 — pull 이 다른 연결의 노트를 덮어쓰지 않는다
+ * - 읽기는 볼트 안이면 폴더 밖도 된다(`../.obsidian/types.json` — Obsidian 설정은 볼트 맨 위에 하나다)
+ */
+declare class ScopedVaultFS implements VaultFS {
+    private readonly base;
+    private readonly folder;
+    private readonly nested;
+    /**
+     * @param folder 이 연결의 폴더(볼트 상대). `""` 이면 볼트 맨 위.
+     * @param connections 볼트의 연결 폴더 전부 — 이 폴더 안쪽 것만 골라 비켜 간다.
+     */
+    constructor(base: VaultFS, folder: string, connections: readonly string[]);
+    ownsPath(path: string): boolean;
+    /** 이 연결의 경로 → 볼트 경로. */
+    private toBase;
+    /** 볼트 경로 → 이 연결의 경로. 이 연결이 맡지 않으면 null. */
+    private fromBase;
+    readFile(path: string): Promise<string>;
+    readBinary(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string): Promise<void>;
+    writeBinary(path: string, data: Buffer): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    moveFile(from: string, to: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    ensureFolder(path: string): Promise<void>;
+    /** 맡은 노트만 읽는다 — 볼트 전체의 본문을 읽지 않는다. */
+    listMarkdownFiles(): Promise<FileInfo[]>;
+    listMarkdownFileStats(): Promise<FileStatInfo[]>;
+    listNonMarkdownFiles(): Promise<NonMdFileInfo[]>;
+    getFileStat(path: string): Promise<FileStatInfo | null>;
+    private rebase;
+}
+
+/**
+ * 볼트의 연결 폴더(ADR-038) — 자기 `.im-nobsidian/` 를 둔 폴더. 볼트 맨 위(`""`)는 그 폴더가 있으면 든다.
+ * 점으로 시작하는 폴더(`.obsidian` · `.git` · `.trash` 등)는 들여다보지 않는다 — 노트 목록도 그렇게 걷는다.
+ */
+declare function findConnectionFolders(vaultRoot: string): Promise<string[]>;
+
 interface PipelineOptions {
     readonly wikilinkResolver?: WikilinkResolverFn;
 }
@@ -3731,6 +4100,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/**";
+/** Obsidian 설정 폴더 기본 이름(볼트 맨 위). 사용자가 바꿀 수 있어 플러그인은 `vault.configDir` 를 쓴다. */
+declare const OBSIDIAN_CONFIG_DIR = ".obsidian";
 /**
  * 주어진 vault 상대 경로(POSIX)가 내부 메타데이터 디렉터리에 속하는지 판별한다.
  */
@@ -3823,4 +4194,36 @@ declare function parseDesignColor(token: string | undefined): DesignColor | unde
 /** 한 줄을 읽는다. 마커가 없는 줄은 글 조각 하나뿐인 결과를 돌려준다. */
 declare function readDesignLine(line: string): DesignLine;
 
-export { BaseFileGenerator, type BaseFileOptions, type BasePropertyOption, type BasePropertySchema, type BaseStatusGroup, type BaseSyncOptions, type BasesFilterNode, type BasesViewMapping, type BasesViewType, BlankLineCollapser, type BookmarkTarget, CONFIG_FILE, type CalendarEntry, type CalloutDesign, CalloutRestorer, CalloutTransformer, ChangeDetector, type ChangeDiff, ColorAnnotator, type CompletenessFailure, type CompletenessLocalSource, type CompletenessOptions, type CompletenessRemoteSource, type CompletenessReport, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, 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 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, 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, 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, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type NotionSidecar, type OperationType, type PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, type PathFilterConfig, type PendingOperation, PendingWalError, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type RecordPendingInput, type RegisterFileInput, type RemoteChange, 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, 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, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, type ViewPropertyConfig, type ViewRenderData, type ViewType, WIKILINK_LOOKUPS, type WatchSyncOptions, type WatchSyncScope, WatchSyncService, type WikilinkEntry, type WikilinkLookup, WikilinkResolver, applicableChoices, assertNoPendingWal, basesViewMappingOf, basesViewTypeOf, choiceForStrategy, classifyBodyFidelity, compactNotionId, computeBufferHash, computeHash, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasDesignMarker, inAnyPathScope, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, noteNameFromPath, notionIdFromInput, notionIdsEqual, operationLabel, parseDesignColor, pendingWalBytes, readDesignLine, resolvePropertyName, sanitizeFileName, setLogger, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness };
+/**
+ * Notion 컬럼이 볼트 노트의 어느 줄에 걸치나 (#74).
+ *
+ * pull 은 컬럼을 위아래로 펼치고 경계를 마커 줄로 남긴다(ADR-008) — `column-list:start` · 열마다
+ * `column[:ratio=N]` · `column-list:end`. Obsidian 은 마크다운을 옆으로 나란히 그리지 못하므로, 플러그인은
+ * 이 결과로 열의 경계를 보이게 칠한다. 마커 모양의 주인이 이 패키지라 읽기도 여기 둔다.
+ *
+ * 컨테이너(콜아웃 · 토글) 안의 컬럼은 pull 이 마커를 지우고 펼친다 — 마커 줄은 맨 앞 들여쓰기만 받는다.
+ */
+/** 컬럼 마커가 있을 수 있는가 — 없으면 줄을 나누어 읽지 않아도 된다. */
+declare function hasColumnLayout(text: string): boolean;
+/** 컬럼 안의 줄 하나가 놓인 자리. */
+interface ColumnPlace {
+    /** 노트 안에서 몇 번째 컬럼 묶음인가 — 0 부터. */
+    readonly group: number;
+    /** 묶음 안에서 몇 번째 열인가 — 0 부터. */
+    readonly index: number;
+    /** 묶음의 열 수. */
+    readonly count: number;
+    /** 열 너비(%) — Notion 이 비율을 주지 않았으면 undefined. */
+    readonly ratio?: number;
+    /** 이 열의 첫 줄인가 — 열 구분 마커 줄이다. */
+    readonly head: boolean;
+}
+/**
+ * 줄마다 놓인 컬럼 자리 — 컬럼 밖 줄 · 묶음의 시작/끝 마커 줄은 undefined. 닫히지 않은 묶음은 노트 끝까지다.
+ * 코드 블록 안의 마커 모양 글은 마커가 아니다.
+ */
+declare function readColumnLayout(lines: readonly string[]): (ColumnPlace | undefined)[];
+/** 열 이름표 — `열 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, 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 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, 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, 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 PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, type PathFilterConfig, type PendingOperation, PendingWalError, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type RecordPendingInput, type RegisterFileInput, type RemoteChange, 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, 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, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, 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, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasColumnLayout, hasDesignMarker, inAnyPathScope, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, normalizeVaultPath, noteNameFromPath, notionIdFromInput, notionIdsEqual, operationLabel, parseDesignColor, pendingWalBytes, readColumnLayout, readDesignLine, resolvePropertyName, sanitizeFileName, setLogger, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };