codemirror-obsidian-md 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Adriano Araújo (adrianoaraujodsantos@hotmail.com).
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,149 @@
-# Temporary Holding Version
+# codemirror-obsidian-md
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A CodeMirror 6 editor for Obsidian Notes (in progress, see the project spec).
+
+## Storage
+
+The editor saves through a `Storage` object you pass in (`read`, `write`, `create`, `delete`, and an optional `lock` capability).
+
+```ts
+import type { Storage } from "codemirror-obsidian-md/storage";
+import { createFilesystemStorage } from "codemirror-obsidian-md/storage/filesystem";
+
+const storage = createFilesystemStorage({ root: "./content" });
+```
+
+Stale writes throw `StaleShaError`; creating an existing path throws `AlreadyExistsError`.
+
+To test your own adapter, run the shared suite from a Vitest file:
+
+```ts
+import { runStorageContract } from "codemirror-obsidian-md/storage/contract";
+
+runStorageContract("my adapter", async () => ({ storage: makeStorage() }));
+```
+
+### GitHub
+
+`codemirror-obsidian-md/storage/github` (server-side only, it holds the write credential) commits through the Contents API. Each save, create and delete is one commit: `Update|Create|Delete <path>` plus `Edited-with` and `Edited-by` trailers built from the `editor` you pass (take it from the verified session, never from the client).
+
+```ts
+import { createGithubStorage } from "codemirror-obsidian-md/storage/github";
+
+const storage = createGithubStorage({
+  repo: "owner/name",
+  branch: "main", // default: the repo's default branch
+  vaultPath: "content", // default: the repo root
+  // A fine-grained PAT, a GitHub App installation, or both (the App wins).
+  credential: { token: process.env.GITHUB_TOKEN },
+  editor: { name: session.user.name, login: session.user.login },
+  deployedCommit: async () => buildSha, // adds `lock`; null when the host has no build commit
+  // fetch and baseUrl are injectable (GitHub Enterprise, tests).
+});
+```
+
+A stale SHA throws `StaleShaError` (with `newer.author` and `newer.time` when GitHub reports them) and an existing path throws `AlreadyExistsError`. `lock.isDeployed(commit)` is true when the deployed commit is identical to or ahead of `commit`.
+
+### Browser adapter
+
+Mount `createStorageHandler` from `codemirror-obsidian-md/storage/http` in a route handler (check the session inside `getStorage`; throw a `Response` to refuse). In the browser use `createStorageClient({ url: "/api/storage", lock: true })` from `codemirror-obsidian-md/storage/client`. It sends no token; the cookie authenticates and the token stays on the server.
+
+### Fake Contents API
+
+`createFakeContentsApi` from `codemirror-obsidian-md/storage/github-fake` is an in-memory GitHub with real SHA semantics (409 stale, 422 existing, commits, compare, App token minting). Pass its `fetch` and `baseUrl` to `createGithubStorage`, or wrap its `fetch` in an HTTP server for end-to-end tests. `externalWrite` simulates another person's commit.
+
+## Editor
+
+The document is the Note's raw Markdown, so saving never rewrites syntax you did not touch (CRLF, a missing trailing newline and odd Frontmatter included). Load it only on your edit route.
+
+```ts
+import { createEditor } from "codemirror-obsidian-md/editor";
+
+const editor = createEditor({
+  parent: document.querySelector("#editor")!,
+  doc: markdown,
+  providers: [], // Live Preview decoration providers, see below
+  idleMs: 250, // re-parse after this much idle time
+  onChange: (text) => markDirty(text !== markdown),
+});
+
+await storage.write(path, editor.getText(), sha); // the Save payload is exactly the document
+editor.destroy();
+```
+
+Peer dependencies: `remark-obsidian-md` (the parser, ADR 0014), `@codemirror/state` and `@codemirror/view`.
+
+### How it works
+
+1. `createNoteParser()` parses the Note with `unified().use(remarkParse).use(remarkGfm).use(remarkMath).use(remarkObsidianMd)` (parse only, no transform, so Comments keep their positions). Frontmatter is skipped. Tables, fenced code, math, Mermaid and reference footnotes (`PLAIN_SOURCE_TYPES`) yield no constructs, so they stay plain source.
+2. Every other MDAST node becomes a `Construct { type, from, to, node }`.
+3. The parse is re-run on the whole Note, debounced to idle. While you type, constructs and decorations are mapped through the edits.
+4. Each `ConstructProvider` whose `types` include a construct's `type` is asked to decorate it.
+
+### Extension points
+
+Later Live Preview work adds to the core without changing it.
+
+- **Decoration providers.** Implement `ConstructProvider` and pass it in `providers`, or register it from any extension with `constructProviders.of(provider)`:
+
+  ```ts
+  import { Decoration } from "@codemirror/view";
+  import type { ConstructProvider } from "codemirror-obsidian-md/editor";
+
+  const highlights: ConstructProvider = {
+    name: "highlight",
+    types: ["obsidianHighlight"], // MDAST node types: wikiLink, embed, obsidianComment, obsidianFootnote, blockquote, heading, ...
+    decorate(construct, { revealed }) {
+      if (revealed) return null; // cursor inside: show the raw syntax
+      return Decoration.mark({ class: "obsidian-highlight" }).range(construct.from, construct.to);
+    },
+  };
+  ```
+
+  A provider returns one `Range<Decoration>`, an array of them, or nothing. Decorations may hide, replace or restyle text, never change it. Widgets are CodeMirror widgets reusing the plugin Stylesheet class names.
+- **Cursor reveal.** `context.revealed` is `isRevealed(state, construct.from, construct.to)`. Call `isRevealed(state, from, to)` yourself for another range (a whole Callout, a line).
+- **Parser.** Pass `parser: (text) => Construct[]` to replace the default, e.g. to add block-level scans such as `scanBlockIds`.
+- **Extra extensions** (autocomplete picker, keymaps, save flow): pass `extensions`, or use `obsidianMd(doc, options)` to compose the core into your own `EditorState`. `reparse(view)` forces a re-parse; `constructsField` and `decorationsField` expose the state.
+
+- **Callouts and Embeds.** `calloutEmbed({ types?, resolveAsset? })` (pass it in `extensions`) renders Callouts, Asset Embeds (images) and Note Embeds (chips) with the plugin Stylesheet class names; import `remark-obsidian-md/styles.css` for the colors and icons. The editor gets the `markdown-rendered` class.
+
+Decorations are rebuilt when a re-parse lands or the selection moves, and only mapped while typing.
+
+Line breaks: the document always splits on `\n`, so a `\r` stays a character and positions equal text offsets. In a Note that is purely CRLF, Enter inserts `\r\n`.
+
+### `[[` picker
+
+`pickerExtension({ candidates, resolver?, maxResults? })` (pass it in `extensions`) opens a Note picker when `[[` is typed. `candidates` is `NoteCandidate[]` (`{ path, title?, aliases? }`) or a getter, ranked by `rankCandidates`. Choosing one inserts a closed Wiki Link; `wikiLinkTarget` uses the bare name when the injected `Resolver` (or, by default, name uniqueness) reaches that Note, else the path.
+
+### Save flow
+
+`createSaveFlow({ storage, path, content, sha, getText, confirm })` saves through a `Storage`. Pass `saveFlowExtension(flow)` in `extensions` (dirty tracking, Mod-s), call `flow.attachBeforeUnload()` for the leave-page warning and `mountConflictBanner(flow, parent)` for the conflict banner. `confirm(request)` is the host's dialog (`kind` is `save`, `overwrite` or `reload`; `request.message` is ready to show). A stale SHA commits nothing and sets `state.status` to `conflict`; `flow.overwrite()` refetches the base SHA and re-asks through `confirm`. `flow.subscribe` and `flow.onSaved` (with the `commit` for `Storage.lock`) are the hooks for lock handling.
+
+### Lock after Save
+
+`createSaveLock(flow, { storage, firstPollMs, intervalMs, timeoutMs })` listens to `flow.onSaved`. When `storage.lock` exists and the Save returned a `commit`, `lock.state.status` becomes `locked`; it polls `storage.lock.isDeployed(commit)` first after `firstPollMs` (1 minute), then every `intervalMs` (5 seconds), and returns to `unlocked` as soon as the deploy is live. After `timeoutMs` (5 minutes) the status is `timeout`: offer `lock.reload()` (Reload from GitHub, through the flow's `confirm`) and `lock.keepWaiting()`. If the Save returns no `commit`, `state.notice` is set once and nothing locks. Without `storage.lock`, and on a conflict, it never locks. Use `lock.subscribe` to disable the editor and `lock.dispose()` on unmount.
+
+### Inline Live Preview
+
+`inlineProviders` renders Wiki Links, Highlights (with Highlight Color), Comments, inline Footnotes and Block IDs, revealing the raw syntax under the cursor. Block IDs are not parse nodes, so wrap the parser with `blockIdParser()`:
+
+```ts
+createEditor({ parent, doc, providers: inlineProviders, parser: blockIdParser() });
+```
+
+## New Note screen
+
+`codemirror-obsidian-md/new-note` is a framework-agnostic DOM component (the package has no React) plus the pure validation it uses. `Storage` cannot list files, so the host passes the Vault-relative paths of existing Notes.
+
+```ts
+import { createNewNoteScreen } from "codemirror-obsidian-md/new-note";
+
+const screen = createNewNoteScreen({
+  parent: document.querySelector("#new-note")!,
+  existingPaths, // e.g. ["Index.md", "Geografia/Seba.md"]
+  onCreate: (path) => storage.create(path, ""), // Vault-relative, ends in .md
+  onCancel: () => history.back(),
+});
+```
+
+The folder field offers existing folders and accepts a typed nested one; a folder exists only once a Note is created in it. `resolveNewNote({ folder, name, existing })` returns `{ ok: true, path }` or `{ ok: false, error }` (empty name, leading `/`, `..` segment, characters GitHub paths reject, existing path, case-only difference). `listFolders(paths)` derives the picker list.

package/dist/editor/cursor.d.ts

@@ -0,0 +1,8 @@
+import type { EditorState } from "@codemirror/state";
+/**
+ * The cursor-reveal helper: true when any selection range touches
+ * `[from, to]` (ends included), so a construct under the cursor shows its raw
+ * syntax. Providers call this to decide between the rendered and raw form.
+ */
+export declare function isRevealed(state: EditorState, from: number, to: number): boolean;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/editor/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/editor/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAKT"}

package/dist/editor/cursor.js

@@ -0,0 +1,13 @@
+/**
+ * The cursor-reveal helper: true when any selection range touches
+ * `[from, to]` (ends included), so a construct under the cursor shows its raw
+ * syntax. Providers call this to decide between the rendered and raw form.
+ */
+export function isRevealed(state, from, to) {
+    for (const range of state.selection.ranges) {
+        if (range.from <= to && range.to >= from)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/editor/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/editor/cursor.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,KAAkB,EAClB,IAAY,EACZ,EAAU;IAEV,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/editor/index.d.ts

@@ -0,0 +1,12 @@
+export { isRevealed } from "./cursor.js";
+export * from "./lock.js";
+export { type CreateEditorOptions, createEditor, type EditorHandle, } from "./mount.js";
+export { createNoteParser, frontmatterLength, PLAIN_SOURCE_TYPES, } from "./parse.js";
+export { type NoteCandidate, type PickerOptions, pickerExtension, rankCandidates, wikiLinkTarget, } from "./picker.js";
+export { type CalloutEmbedOptions, calloutEmbed, } from "./providers/callout-embed.js";
+export { blockIdParser, blockIdProvider, commentProvider, footnoteProvider, highlightProvider, inlineProviders, wikiLinkProvider, } from "./providers/inline.js";
+export { markdownProvider } from "./providers/markdown.js";
+export * from "./save-flow.js";
+export { constructProviders, constructsField, DEFAULT_IDLE_MS, decorationsField, isCrlf, type ObsidianMdOptions, obsidianMd, reparse, } from "./state.js";
+export type { Construct, ConstructProvider, DecorationContext, NoteParser, ProviderResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,OAAO,EACL,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,mBAAmB,EACxB,YAAY,GACb,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,KAAK,iBAAiB,EACtB,UAAU,EACV,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/editor/index.js

@@ -0,0 +1,11 @@
+export { isRevealed } from "./cursor.js";
+export * from "./lock.js";
+export { createEditor, } from "./mount.js";
+export { createNoteParser, frontmatterLength, PLAIN_SOURCE_TYPES, } from "./parse.js";
+export { pickerExtension, rankCandidates, wikiLinkTarget, } from "./picker.js";
+export { calloutEmbed, } from "./providers/callout-embed.js";
+export { blockIdParser, blockIdProvider, commentProvider, footnoteProvider, highlightProvider, inlineProviders, wikiLinkProvider, } from "./providers/inline.js";
+export { markdownProvider } from "./providers/markdown.js";
+export * from "./save-flow.js";
+export { constructProviders, constructsField, DEFAULT_IDLE_MS, decorationsField, isCrlf, obsidianMd, reparse, } from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAEL,YAAY,GAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,YAAY,GACb,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,MAAM,EAEN,UAAU,EACV,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/editor/lock.d.ts

@@ -0,0 +1,46 @@
+import type { Storage } from "../storage/types.js";
+import type { SaveFlow } from "./save-flow.js";
+export type SaveLockStatus = "unlocked" | "locked" | "timeout";
+export interface SaveLockState {
+    /**
+     * `locked`: a Save is waiting for its deploy, so the Note must not be
+     * edited. `timeout`: the deploy did not appear in time; offer `reload()`
+     * and `keepWaiting()`.
+     */
+    status: SaveLockStatus;
+    /** One-time message, set when the host exposes no build commit. */
+    notice: string | null;
+}
+export interface SaveLockOptions {
+    storage: Storage;
+    /** Delay before the first poll. Default 1 minute. */
+    firstPollMs?: number;
+    /** Delay between later polls. Default 5 seconds. */
+    intervalMs?: number;
+    /** Total wait, from the Save, before the timeout. Default 5 minutes. */
+    timeoutMs?: number;
+    /**
+     * Start locked on a commit made before the editor opened (for example the
+     * commit that created the Note), as if a Save had just produced it. Needs
+     * `storage.lock`; without it nothing locks.
+     */
+    lockedCommit?: string;
+}
+export interface SaveLock {
+    readonly state: SaveLockState;
+    subscribe(listener: (state: SaveLockState) => void): () => void;
+    /** Timeout only: wait another `timeoutMs`. */
+    keepWaiting(): void;
+    /** Reload the Note from GitHub (through the flow's confirm), then unlock. */
+    reload(): Promise<boolean>;
+    dismissNotice(): void;
+    dispose(): void;
+}
+export declare const NO_COMMIT_NOTICE = "Your host does not expose the build commit, so the editor cannot tell when your change is live. The Note is not locked.";
+/**
+ * Locks the Note after a successful Save until `storage.lock` reports the
+ * deploy is live. Wired through `flow.onSaved`; conflicts and failed saves
+ * never reach it, and a storage without `lock` is never locked.
+ */
+export declare function createSaveLock(flow: SaveFlow, options: SaveLockOptions): SaveLock;
+//# sourceMappingURL=lock.d.ts.map

package/dist/editor/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/editor/lock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAChE,8CAA8C;IAC9C,WAAW,IAAI,IAAI,CAAC;IACpB,6EAA6E;IAC7E,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,aAAa,IAAI,IAAI,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB,4HAC8F,CAAC;AAE5H;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,eAAe,GACvB,QAAQ,CAyFV"}

package/dist/editor/lock.js

@@ -0,0 +1,98 @@
+export const NO_COMMIT_NOTICE = "Your host does not expose the build commit, so the editor cannot tell when your change is live. The Note is not locked.";
+/**
+ * Locks the Note after a successful Save until `storage.lock` reports the
+ * deploy is live. Wired through `flow.onSaved`; conflicts and failed saves
+ * never reach it, and a storage without `lock` is never locked.
+ */
+export function createSaveLock(flow, options) {
+    const { storage } = options;
+    const firstPollMs = options.firstPollMs ?? 60_000;
+    const intervalMs = options.intervalMs ?? 5_000;
+    const timeoutMs = options.timeoutMs ?? 300_000;
+    let state = { status: "unlocked", notice: null };
+    let noticeShown = false;
+    let commit = "";
+    let timer;
+    let generation = 0;
+    const listeners = new Set();
+    function set(patch) {
+        state = { ...state, ...patch };
+        for (const l of [...listeners])
+            l(state);
+    }
+    function stop() {
+        generation++;
+        clearTimeout(timer);
+        timer = undefined;
+    }
+    function start(newCommit) {
+        stop();
+        commit = newCommit;
+        const gen = generation;
+        const startedAt = Date.now();
+        set({ status: "locked" });
+        const poll = async () => {
+            let deployed = false;
+            try {
+                deployed = (await storage.lock?.isDeployed(commit)) === true;
+            }
+            catch {
+                // A failed check means "not yet"; keep polling until the timeout.
+            }
+            if (gen !== generation)
+                return;
+            if (deployed)
+                return set({ status: "unlocked" });
+            const remaining = timeoutMs - (Date.now() - startedAt);
+            if (remaining <= 0)
+                return set({ status: "timeout" });
+            timer = setTimeout(poll, Math.min(intervalMs, remaining));
+        };
+        timer = setTimeout(poll, Math.min(firstPollMs, timeoutMs));
+    }
+    if (options.lockedCommit && storage.lock)
+        start(options.lockedCommit);
+    const offSaved = flow.onSaved((result) => {
+        if (!storage.lock)
+            return;
+        if (result.commit === undefined) {
+            if (!noticeShown) {
+                noticeShown = true;
+                set({ notice: NO_COMMIT_NOTICE });
+            }
+            return;
+        }
+        start(result.commit);
+    });
+    return {
+        get state() {
+            return state;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        keepWaiting() {
+            if (state.status === "timeout")
+                start(commit);
+        },
+        async reload() {
+            const ok = await flow.reload();
+            if (ok) {
+                stop();
+                set({ status: "unlocked" });
+            }
+            return ok;
+        },
+        dismissNotice() {
+            if (state.notice !== null)
+                set({ notice: null });
+        },
+        dispose() {
+            stop();
+            offSaved();
+            listeners.clear();
+        },
+    };
+}
+//# sourceMappingURL=lock.js.map

package/dist/editor/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/editor/lock.ts"],"names":[],"mappings":"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"}

package/dist/editor/mount.d.ts

@@ -0,0 +1,24 @@
+import { type Extension } from "@codemirror/state";
+import { EditorView } from "@codemirror/view";
+import { type ObsidianMdOptions } from "./state.js";
+export interface CreateEditorOptions extends ObsidianMdOptions {
+    /** Element the editor mounts into. */
+    parent: HTMLElement;
+    /** The Note's raw Markdown. */
+    doc: string;
+    /** Extra extensions, appended after the core ones. */
+    extensions?: readonly Extension[];
+    /** Called with the full text after every document change. */
+    onChange?: (text: string) => void;
+}
+export interface EditorHandle {
+    readonly view: EditorView;
+    /** The Save payload: exactly the document text, nothing re-serialized. */
+    getText(): string;
+    /** Re-parse now instead of waiting for idle. */
+    reparse(): void;
+    destroy(): void;
+}
+/** Mounts the editor on a Note's raw Markdown. */
+export declare function createEditor(options: CreateEditorOptions): EditorHandle;
+//# sourceMappingURL=mount.d.ts.map

package/dist/editor/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/editor/mount.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAU,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,sCAAsC;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,IAAI,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA0BvE"}

package/dist/editor/mount.js

@@ -0,0 +1,34 @@
+import { defaultKeymap, history, historyKeymap } from "@codemirror/commands";
+import { EditorState } from "@codemirror/state";
+import { EditorView, keymap } from "@codemirror/view";
+import { obsidianMd, reparse } from "./state.js";
+/** Mounts the editor on a Note's raw Markdown. */
+export function createEditor(options) {
+    const { parent, doc, onChange } = options;
+    const view = new EditorView({
+        parent,
+        state: EditorState.create({
+            doc,
+            extensions: [
+                history(),
+                keymap.of([...defaultKeymap, ...historyKeymap]),
+                EditorView.lineWrapping,
+                obsidianMd(doc, options),
+                onChange
+                    ? EditorView.updateListener.of((u) => {
+                        if (u.docChanged)
+                            onChange(u.state.doc.toString());
+                    })
+                    : [],
+                options.extensions ?? [],
+            ],
+        }),
+    });
+    return {
+        view,
+        getText: () => view.state.doc.toString(),
+        reparse: () => reparse(view),
+        destroy: () => view.destroy(),
+    };
+}
+//# sourceMappingURL=mount.js.map

package/dist/editor/mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.js","sourceRoot":"","sources":["../../src/editor/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAA0B,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAsBzE,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;QAC1B,MAAM;QACN,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC;YACxB,GAAG;YACH,UAAU,EAAE;gBACV,OAAO,EAAE;gBACT,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,aAAa,CAAC,CAAC;gBAC/C,UAAU,CAAC,YAAY;gBACvB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;gBACxB,QAAQ;oBACN,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;wBACjC,IAAI,CAAC,CAAC,UAAU;4BAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACrD,CAAC,CAAC;oBACJ,CAAC,CAAC,EAAE;gBACN,OAAO,CAAC,UAAU,IAAI,EAAE;aACzB;SACF,CAAC;KACH,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;QACxC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE;KAC9B,CAAC;AACJ,CAAC"}

package/dist/editor/parse.d.ts

@@ -0,0 +1,17 @@
+import type { NoteParser } from "./types.js";
+/**
+ * Node types the MVP shows as plain source (tables, fenced code, math,
+ * Mermaid, reference footnotes). They are never emitted and never descended
+ * into, so nothing inside them is decorated.
+ */
+export declare const PLAIN_SOURCE_TYPES: ReadonlySet<string>;
+/** Length of the Frontmatter block at the top of `text` (0 if none). */
+export declare function frontmatterLength(text: string): number;
+/**
+ * Builds the parser from the plugin pipeline (ADR 0014): remark-parse,
+ * remark-gfm and remark-obsidian-md. Only `parse` runs, never the plugin's
+ * transform, so the tree keeps every construct (Comments included) at its
+ * source position.
+ */
+export declare function createNoteParser(): NoteParser;
+//# sourceMappingURL=parse.d.ts.map

package/dist/editor/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/editor/parse.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAQjD,CAAC;AAKH,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAoB7C"}

package/dist/editor/parse.js

@@ -0,0 +1,65 @@
+import remarkGfm from "remark-gfm";
+import remarkMath from "remark-math";
+import { remarkObsidianMd } from "remark-obsidian-md/syntax";
+import remarkParse from "remark-parse";
+import { unified } from "unified";
+/**
+ * Node types the MVP shows as plain source (tables, fenced code, math,
+ * Mermaid, reference footnotes). They are never emitted and never descended
+ * into, so nothing inside them is decorated.
+ */
+export const PLAIN_SOURCE_TYPES = new Set([
+    "table",
+    "code",
+    "math",
+    "inlineMath",
+    "footnoteDefinition",
+    "footnoteReference",
+    "yaml",
+]);
+const FRONTMATTER = /^---[ \t]*\r?\n(?:[\s\S]*?\r?\n)?(?:---|\.\.\.)[ \t]*(?:\r?\n|$)/;
+/** Length of the Frontmatter block at the top of `text` (0 if none). */
+export function frontmatterLength(text) {
+    return FRONTMATTER.exec(text)?.[0].length ?? 0;
+}
+/**
+ * Builds the parser from the plugin pipeline (ADR 0014): remark-parse,
+ * remark-gfm and remark-obsidian-md. Only `parse` runs, never the plugin's
+ * transform, so the tree keeps every construct (Comments included) at its
+ * source position.
+ */
+export function createNoteParser() {
+    const processor = unified()
+        .use(remarkParse)
+        .use(remarkGfm)
+        .use(remarkMath)
+        .use(remarkObsidianMd);
+    return (text) => {
+        // Frontmatter is plain source; parsing it would turn `---` into rules.
+        const offset = frontmatterLength(text);
+        let tree;
+        try {
+            tree = processor.parse(text.slice(offset));
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        walk(tree, offset, out);
+        return out;
+    };
+}
+function walk(node, offset, out) {
+    if (PLAIN_SOURCE_TYPES.has(node.type))
+        return;
+    const start = node.position?.start.offset;
+    const end = node.position?.end.offset;
+    if (node.type !== "root" && start !== undefined && end !== undefined) {
+        out.push({ type: node.type, from: start + offset, to: end + offset, node });
+    }
+    if ("children" in node) {
+        for (const child of node.children)
+            walk(child, offset, out);
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/editor/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/editor/parse.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IAC7D,OAAO;IACP,MAAM;IACN,MAAM;IACN,YAAY;IACZ,oBAAoB;IACpB,mBAAmB;IACnB,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,WAAW,GACf,kEAAkE,CAAC;AAErE,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,OAAO,EAAE;SACxB,GAAG,CAAC,WAAW,CAAC;SAChB,GAAG,CAAC,SAAS,CAAC;SACd,GAAG,CAAC,UAAU,CAAC;SACf,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEzB,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,uEAAuE;QACvE,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,IAAW,CAAC;QAChB,IAAI,CAAC;YACH,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,IAAW,EAAE,MAAc,EAAE,GAAgB;IACzD,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC;IACtC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,KAAK,IAAK,IAAe,CAAC,QAAQ;YAC3C,IAAI,CAAC,KAAc,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/editor/picker.d.ts

@@ -0,0 +1,40 @@
+import type { Extension } from "@codemirror/state";
+import type { Resolver } from "remark-obsidian-md";
+/** A Note the host offers in the picker. */
+export interface NoteCandidate {
+    /** Vault path, e.g. `Projects/Roadmap.md`. */
+    path: string;
+    /** Display name. Default: the file name without its extension. */
+    title?: string;
+    /** Alias names the Note can also be found by. */
+    aliases?: readonly string[];
+}
+export interface PickerOptions {
+    /** The Vault's Notes, or a getter read on every open so props can change. */
+    candidates: readonly NoteCandidate[] | (() => readonly NoteCandidate[]);
+    /**
+     * Decides which target reaches a Note, so the inserted link resolves the
+     * same as on the Wiki (ADR 0003). Default: the bare name unless another
+     * candidate shares it, else the path.
+     */
+    resolver?: Resolver;
+    /** Maximum options shown. Default 100. */
+    maxResults?: number;
+}
+/**
+ * Ranks Notes by the typed text: exact title, title prefix, word start,
+ * substring, Alias, path, then subsequence. Ties: shorter title, then path.
+ * An empty query returns every candidate by path.
+ */
+export declare function rankCandidates(candidates: readonly NoteCandidate[], query: string): NoteCandidate[];
+/**
+ * The Wiki Link target that reaches `candidate`: the bare name when it
+ * resolves to the Note, otherwise the path (both without `.md`).
+ */
+export declare function wikiLinkTarget(candidate: NoteCandidate, all: readonly NoteCandidate[], resolver?: Resolver): string;
+/**
+ * The `[[` picker: typing `[[` opens a list of the host's Notes ranked by the
+ * text typed after it; choosing one inserts a closed Wiki Link.
+ */
+export declare function pickerExtension(options: PickerOptions): Extension;
+//# sourceMappingURL=picker.d.ts.map

package/dist/editor/picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../src/editor/picker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,CAAC,MAAM,SAAS,aAAa,EAAE,CAAC,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA0ED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,KAAK,EAAE,MAAM,GACZ,aAAa,EAAE,CAEjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,SAAS,aAAa,EAAE,EAC7B,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,CAgBR;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CA6BjE"}