Push a new toast with the default lifetime. Use the typed `kind` to drive the icon + color; the renderer maps semantics to colors consistently.

Returns the underlying string slice.

Read every actor present in `<workspace>/ops/` and return the full set of `(actor, node)` pairs materialized from the `Op::Create` ops on disk. Going

Replace the block's text with `new_text` verbatim. `new_text` is the **raw** wire text, prefix and all. Callers that surface TODO/DONE state separate

Reparse the current page from disk + (re)trigger auto-run. Most navigation paths call this. The auto-run pass is what makes `auto-run::` blocks "feel

Convenience: `Move` with sentinel `old_*` (the algorithm overwrites these on `do_op`).

Open (or create) whatever page a user-typed **ref target** points at — `[[avelino/outl]]`, `[[2026-06-04]]`, `[[São Paulo]]`, `[[Q4 plan]]`, a `#tag`

Push the current page state onto the undo stack. Clears the redo stack — that's vim semantics: a new edit branches history.

Actor id of this generator.

Append an op at the tail. Callers (`Tree::apply_op` in particular) are responsible for ensuring that `op.ts > self.last().ts`; the log does not re-so

Score-only convenience.

Parse a human chord string like `"Ctrl+Shift+A"` or `"Ctrl+T S"` (space-separated chords) into a sequence. Used to turn a plugin's `contributes.keybin

Append a new block as the last child of `parent`. Synonym for [`append_block`] when the parent is explicit.

`[[YYYY-MM-DD]]` for today + `days_offset`. Negative offsets are past, positive are future.

Load and activate a plugin from an already-read manifest + bundle. `approved` is the permission set the user approved (from the lockfile); `config` i

Build the on-disk path for a given page's `.md` projection.

Base style for elevated surfaces (popups, toasts): `popup_bg` background plus the theme's base text color. Every overlay paints this before its conten

Borrow the sibling list of a path (i.e. the parent's children).

Acquire a read-only handle to the workspace. Returns the `workspace_loading` sentinel string while the background opener is still running or the user

Write `contents` to `path` atomically. Steps: 1. Compute a sibling temp path: `path` with `.tmp` appended to the filename (so `pages/foo.md` becomes

Every command in the registry, in registration order. The slash menu calls this to populate its list.

Convenience: backlinks against either the page's slug or its title. When the page is a person (`page_type == Some("person")`), we also scan for the *

Look up a page by its slug.

Enter Insert mode at the currently focused block. Dispatches by `Focus`: outline blocks edit `App.page`; backlink blocks load the source page from di

Count of all nodes in the (possibly nested) outline.

Initialize the clock from the user's configured timezone. `tz` is the raw `[calendar] timezone` value from `config.toml` — an IANA name (`"Europe/Lon

Read-only access to the in-memory op log.

External markdown syntax → outl syntax. Pure string-level transforms applied to clipboard text before it reaches `outl_md::parse::parse`. Reads no wo

Parse a `NodeId` from its string ULID form.

The `.outl/plugins` directory under a workspace root.

Record the pre-mutation state. Clears the redo stack — vim semantics: a new edit branches history.

Run a plugin command, applying whatever intents it emits.

Convert a user-visible page name into a filesystem-safe slug.

Spawn the plugin thread and return a handle to it. The thread loads every installed plugin from `<root>/.outl/plugins/` on the first request after th

Acquire a mutable handle to the workspace.

Commit Insert: write buffer back into the AST and persist. Routes by `EditTarget`: - `CurrentPage`: mutate `app.page`, snapshot undo, `save()`. - `So

Insert `text` at the cursor if we're in Insert mode; otherwise surface a status message — date commands only make sense while the user is typing.

Build the plugin host and load every installed plugin. Best-effort end to end: on any unexpected error this leaves `plugin_host = None` and returns —

Set (or clear, with `value = None`) a property on `node`. One-liner over `Op::SetProp` exposed so every client can write properties without reaching

Split a block's raw text into `(state, body)`. The body never includes the prefix or its trailing space.

Create a page (idempotent on slug).

Default fallback when nothing is configured.

Apply a workspace mutation `f` and project the result back to `.md` + sidecar. The op log is the source of truth: the `.md` and the sidecar are proje

Iterate every (node, parent, position) triple. Useful for tests.

Borrow the node at a path. `None` if any segment is out of range.

Look up a block by its short ref handle (`blk-XXXXXX`). O(1). Returns `None` for unknown handles, including orphaned ones (block deleted but a `.md`

Spawn the shared plugin thread with the desktop's client id, capability set, and swap-capable storage root. Called once in `lib.rs::setup`; the return

Today's date in the user's configured timezone (falling back to the OS local timezone). Delegates to [`crate::clock`] so the journal's "today" honours

Persist this id to `<root>/.outl/workspace-id`, creating the `.outl/` directory if needed. Used both on first generation and by pairing adoption (the

The approved permissions.

Render as `String`.

Cycle the TODO prefix directly on an [`EditBuffer`], preserving the cursor's *visual* position relative to the user's text. - none → `TODO `: prefix

Build a fake keydown with the fields the handler reads plus spied * preventDefault / stopPropagation.

A nav over 3 string items with spied callbacks, starting at `index`. * Return type is inferred so the `vi.fn()` mock types stay intact for * `toHa

Strip the `[[ ... ]]` wrap and parse the inner ISO date.