If `char_index` falls inside a `[[ref]]`, `#tag`, or `[[date]]` token in `text`, return the corresponding [`RefTarget`]. Otherwise `None`.

Resolve `((blk-XXXXXX))` to the indexed block, if known. `O(1)`. Returns `None` for handles that don't match any indexed block — orphan references ar

Build the shared slots the way `AppState` does: an open, persisted workspace rooted under `root` with one page + block.

Flatten `candidates` into the exact visual order the palette paints: buckets grouped by category, buckets sorted by [`category_order`], the relative o

Add a peer and persist to disk.

Full set of created-node ids on a workspace's disk, regardless of authoring actor (reads every `ops-*.jsonl` via the production storage). Lives here

Pull the first arg as a Rust `String` (defaults to empty).

Compare two tree states for structural equivalence. Returns `Ok(())` if both trees agree on every node's parent + position and on every property bind

Convenience: backlinks for the currently-opened page/journal.

Every block in the workspace that mentions `target` — either as a literal `[[target]]` substring or as a `#tag` token whose slug form equals `target`'

Reject an action whose target node is no longer in the materialised tree (e.g. a peer trashed it between the client's read and write).

Pure handler — used by both CLI and MCP shim.

Run a Roam import. `src` is the JSON backup file.

Mutable variant of [`node_at_path`].

* @roadmap Not wired yet — calling this throws at runtime in the current * outl version. Open a page in the active client view.

Open today's journal page, creating it if needed.

Parse the variety of date forms we accept. Keyword shortcuts (`today` / `yesterday` / `tomorrow`) are resolved here; every literal spelling (ISO, `20

Re-index a single page in place — replacement for the global scan when only one page changed. Refreshes the `PageEntry` metadata (title/icon/pinned)

Every property currently set on `node`, as `(key, value)` pairs in unspecified order. Used by projection layers (mobile / TUI outline DTO) to snapsho

Find the path the caller should use right now to read or write the sidecar for `md_path`. In the common case this is the canonical (non-dotted) `<ste

Spawn the shared plugin thread with the mobile client id, capability set, and fixed storage root. Called once in `lib.rs::setup`; the returned handle

Resolve the block the user means right now — the focused * textarea's id (Insert) takes priority over the selection * cursor (Normal). Returns

Cycle the block's TODO state: `None → TODO → DONE → None`.

Decompose a block's `text` into visual rows. `cursor_char`, when present, is a char index into `text` (counting `\n` as one char) at which the active

Insert a new sibling immediately after `after`, sharing the same parent.

Current selected block's text (or empty if no selection). Honours `app.focus` so backlink blocks return their own text.

Cycle the TODO state of `raw` to the next stop. Returns the new text, ready to be stored as the block's content. Aware of an optional leading quote p

Look back from `cursor` over `chars` to find an open `[[` / `#` / `/` / `@` / `:` trigger plus the query typed after it. Returns `None` if no trigger

Create the underlying `.md` file (with a single empty block) if it doesn't already exist. Ensures the editor always has a target.

Parse the language tag and body out of a block whose first line opens a fence. Returns `None` if the text doesn't start with `` ``` `` — i.e. the bloc

Reverse of [`path_for_index`]: given a path, return the flat index.

Insert a string at the cursor.

Build a full [`iroh::EndpointAddr`] for dialing this peer. Resolution order, most-reachable first: 1. The stored full `endpoint_addr` (node id + rela

Whether `node` is currently rendered collapsed (children hidden in the outline view). Defaults to `false` for any node the op log has never explicitly

The public node id (device address).

Parse a YAML frontmatter block into a flat [`Frontmatter`]. - `title` (scalar) is lifted into [`Frontmatter::title`]. - `tags` accepts a scalar (comm

Find blocks matching `filter`.

Handle `resources/read`.

Rename a page's slug. Updates the `page-slug` property, renames the on-disk `.md`, and returns the list of blocks still referencing the old slug so th

Render an [`ExecOutput`] (or a top-level [`ExecError`]) as the markdown body of a result subblock. Format: - Single-line stdout → `> **result:** \`o

The secret key for building an iroh `Endpoint`.

Build the shared slots the way `AppState` does: an open, persisted workspace rooted under `root` with one page + block.

Split a leading `---\n...\n---\n` block from the file. Returns `(Some(yaml_text), body)` when present and well-formed; otherwise `(None, original_text

Dispatch every op applied since the last sweep to plugins' `onOp` hooks, applying any intents they emit. Idempotent and loop-safe.

Today's date in the user's configured timezone (falling back to the OS local timezone), as a `NaiveDate`. Routes through [`outl_actions::clock`] so `[

Build the per-workspace peers path: `<workspace_root>/.outl/peers.json`. The `.outl/` directory already holds the workspace's `workspace-id` and `con

Build a [`LogOp`] wrapping `op` with a fresh HLC.

Append pre-built ops verbatim into `<root>/ops/ops-<actor>.jsonl` via the production `JsonlStorage`. Appending the same op twice plants a historic dup

Run an op on the source page of the focused backlink and persist. `f` receives the source AST (mutable) and the absolute path of the currently focuse

Convert a char index into a `(line, col)` pair using `\n` as the line separator. Indices count *characters*, not bytes. Renderers usually then conver

Iterator over every node currently flagged collapsed. Used by projection layers (sidecar render, mobile wire format) to snapshot the fold state in one

Slug of the currently-opened view, used to look up backlinks.

Every binding outl ships with by default. `Global` entries fire in every mode — those are the OS-standard chrome chords (`Cmd+P`, `Cmd+T`, `Cmd+,`, `

Delete a page by moving its root to the trash. The op stays in the log so peers converge.

Serialize via bincode for persistence in [`crate::storage::Snapshot::bytes`].

Re-emit a tokenized inline span back as the markdown source it came from. Bold / italic / strike now carry recursively-tokenized inners (`Vec<InlineT

Install a plugin from a local directory (the installed-shape: a `plugin.json` plus its bundle and assets). Copies it under `.outl/plugins/<id>/`, hash

Slug for `date` using the canonical `YYYY-MM-DD` shape.

Load every enabled installed plugin (plus any `_dev/` plugins) into `host`. Best-effort: a plugin whose manifest is invalid, whose bundle hash no lon

Path to the lockfile.

One-time migration: when a workspace has no `peers.json` yet but the legacy global** `~/.outl/peers.json` exists, copy the global list into the worksp

Open the Notion-style slash command menu. Bound to `/` in Normal mode. Replaces the old `/` = workspace-search binding — search is now a *command* in

Fractional position for a new last child appended under `parent`. Promoted to `pub` for the CLI's `outl block move --parent=…` flow.

Record a failed dial to `peer`. Keeps any prior `last_rtt_ms` so the UI can show "last seen Nms ago, now offline" if it wants to.

Search the gemoji catalog for shortcodes matching `query`. Ranking (highest first): - exact shortcode match - shortcode starts with the query - short